Tipos de Mensagens
Texto
A mensagem de Texto é o tipo de mensagem mais simples do RCS. Muito semelhante ao SMS tradicional.
Sua principal diferença é seu tamanho, que ao invés dos 160 caracteres do SMS, tem um limite de 5.000 caracteres.
Sua estrutura na requisição deverá ser:
{
"text": {
"message": "Mensagem com limite de 5000 caracteres."
}
}
Imagem
- A mensagem de Imagem permite o envio de uma imagem nos formatos .gif, .jpg ou .png e tamanho máximo de 2MB.
- A resolução ideal para imagens é de 500px por 300px.
- É recomendável deixar a imagem centralizada com uma margem lateral de 100px.
Sua estrutura na requisição deverá ser:
{
"image": {
"url": "https://seusite.com/imagem.png"
}
}Vídeo
- A mensagem de Vídeo permite o envio de um vídeo no mp4.
- O tamanho máximo deve ser de até 50MB.
Sua estrutura na requisição deverá ser:
{
"video": {
"url": "https://seusite.com/video.mp4"
}
}Documento (PDF)
- A mensagem de Documento permite o envio de um arquivo no formato PDF.
- O tamanho máximo deve ser de 2MB.
Sua estrutura na requisição deverá ser:
{
"pdf": {
"url": "https://seusite.com/document.pdf"
}
}Sugestões
O tipo de mensagem Sugestão assemelha-se à uma mensagem de texto convencional, mas tem como diferencial a possibilidade de se adicionar até quatro botões de ação rápida.
O limite da mensagem é de dois mil caracteres.
Sua estrutura na requisição deverá ser:
{
"suggestion":{
"text":"Texto da mensagem!",
"suggestions":[
{
"type":"link",
"title":"Abrir o dChat",
"value":"https://sistema.dchat.com.br"
},
{
"type":"link",
"title":"Visite nosso site",
"value":"https://dfive.com.br"
},
{
"type":"reply",
"title":"Parar de Receber",
"value":"Sair"
},
{
"type":"call",
"title":"Ligar",
"value":"5511999998877"
}
]
}
}Cards
Na opção Card, você combina a comunicação por texto, onde pode enviar mensagens com caracteres especiais, acentos, variáveis e emojis, com a comunicação por imagens, ideal para captar a atenção do seu cliente. Além disso, você pode adicionar até 4 botões.
O limite da mensagem é de dois mil caracteres.
Os arquivos suportados devem estar em formato .gif, .jpg e .png com no máximo 2MB e .mp4 com no máximo 10MB (resolução ideal: 500x300px com borda de até 100x100px).
Sua estrutura na requisição deverá ser:
{
"title":"Dfive Consultoria",
"description":"Oferecemos soluções inovadoras em atendimento e comunicação desde 2019, aprimorando o relacionamento entre empresas e clientes com eficiência e tecnologia de ponta.",
"suggestions":[
{
"title":"Fale conosco",
"type":"link",
"value":"http:/wa.me/1338777102"
},
{
"title":"Ligar agora",
"type":"call",
"value":"1338777102"
}
],
"fileUrl":"https:/sistema.dchat.com.b/storage/rcs-template/1/carousel-3.png"
},Botões
No RCS, existem três tipos de botões para envio via API:
- Link
- Reply
- Call
A estrutura para todos seguem o mesmo padrão contendo o type, que determina o tipo do botão, o title que será o texto do botão (deve conter até 25 caracteres) e o value com o valor do botão.
Link
O botão link abre o navegador com a URL especificada.
Não esqueça que é obrigatório o protocolo, por exemplo https://
Sua estrutura é:
{
"type":"link",
"title":"Visite nosso site",
"value":"https://dfive.com.br"
}Reply
O botão do tipo reply responde o RCS com um SMS contendo o valor da propriedade value. Ele é interessante em opções como o sair de uma lista, ou a confirmação de uma ação.
A cobrança da resposta é feita em sua conta e não do cliente!
Sua estrutura é:
{
"type":"reply",
"title":"Título do botão",
"value":"Resposta que será enviada por SMS"
}Call
O botão do tipo call abre o discador com o número definido em value já preenchido.
Atente-se que se a mensagem for enviada pra um número internacional, você deve incluir o código DDI, por exemplo o +55, no value.
Sua estrutura é:
{
"type":"call",
"title":"Título do botão",
"value":"+5514999998877"
}