# 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.**

[![Imagem do WhatsApp de 2025-02-04 à(s) 10.49.38_02b0c02e.jpg](https://docs.dchat.com.br/uploads/images/gallery/2025-02/scaled-1680-/nwsquKAGoHsgfypC-imagem-do-whatsapp-de-2025-02-04-as-10-49-38-02b0c02e.jpg)](https://docs.dchat.com.br/uploads/images/gallery/2025-02/nwsquKAGoHsgfypC-imagem-do-whatsapp-de-2025-02-04-as-10-49-38-02b0c02e.jpg)

Sua estrutura na requisição deverá ser:

```json
{    
  "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.

[![Imagem do WhatsApp de 2025-02-04 à(s) 11.09.04_47d4c2e1.jpg](https://docs.dchat.com.br/uploads/images/gallery/2025-02/scaled-1680-/55JJvemAEzYqf9vZ-imagem-do-whatsapp-de-2025-02-04-as-11-09-04-47d4c2e1.jpg)](https://docs.dchat.com.br/uploads/images/gallery/2025-02/55JJvemAEzYqf9vZ-imagem-do-whatsapp-de-2025-02-04-as-11-09-04-47d4c2e1.jpg)

Sua estrutura na requisição deverá ser:

```json
{    
  "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.

[![Imagem do WhatsApp de 2025-02-04 à(s) 11.08.06_fe06d208.jpg](https://docs.dchat.com.br/uploads/images/gallery/2025-02/scaled-1680-/IGU7dh7OV8vaiBLn-imagem-do-whatsapp-de-2025-02-04-as-11-08-06-fe06d208.jpg)](https://docs.dchat.com.br/uploads/images/gallery/2025-02/IGU7dh7OV8vaiBLn-imagem-do-whatsapp-de-2025-02-04-as-11-08-06-fe06d208.jpg)

Sua estrutura na requisição deverá ser:

```json
{    
  "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.

[![Imagem do WhatsApp de 2025-02-04 à(s) 11.12.40_a8cf6ada.jpg](https://docs.dchat.com.br/uploads/images/gallery/2025-02/scaled-1680-/kAB96waUKNGmPe9g-imagem-do-whatsapp-de-2025-02-04-as-11-12-40-a8cf6ada.jpg)](https://docs.dchat.com.br/uploads/images/gallery/2025-02/kAB96waUKNGmPe9g-imagem-do-whatsapp-de-2025-02-04-as-11-12-40-a8cf6ada.jpg)

Sua estrutura na requisição deverá ser:

```json
{    
  "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](https://docs.dchat.com.br/books/rcs-api/page/botoes "Botões").

O limite da mensagem é de **dois mil caracteres**.

Sua estrutura na requisição deverá ser:

```json
{
   "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

<span style="font-size: 14px;"><span style="line-height: 115%; font-family: Roboto, sans-serif; color: rgb(0, 0, 0);">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é ](https://docs.dchat.com.br/books/rcs-api/page/botoes "Botões")**[4 botões](https://docs.dchat.com.br/books/rcs-api/page/botoes "Botões")**</span></span>.

O limite da mensagem é de **dois mil caracteres**.

<span style="font-size: 14px; line-height: 115%; font-family: Roboto, sans-serif; color: rgb(0, 0, 0);">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).</span>

[![Imagem do WhatsApp de 2025-02-04 à(s) 14.48.00_2d87a939.jpg](https://docs.dchat.com.br/uploads/images/gallery/2025-02/scaled-1680-/rY5D5Rpdy8vFGHVg-imagem-do-whatsapp-de-2025-02-04-as-14-48-00-2d87a939.jpg)](https://docs.dchat.com.br/uploads/images/gallery/2025-02/rY5D5Rpdy8vFGHVg-imagem-do-whatsapp-de-2025-02-04-as-14-48-00-2d87a939.jpg)

[![image.png](https://docs.dchat.com.br/uploads/images/gallery/2025-02/scaled-1680-/QYOjP9ZjVNNEnNjZ-image.png)](https://docs.dchat.com.br/uploads/images/gallery/2025-02/QYOjP9ZjVNNEnNjZ-image.png)

Sua estrutura na requisição deverá ser:

```json
{
      "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:

1. Link
2. Reply
3. Call

A estrutura para todos seguem o mesmo padrão contendo o `<strong>type</strong>`, que determina o tipo do botão, o `<strong>title</strong>` que será o texto do botão (<span style="color: rgb(224, 62, 45);">**deve conter até 25 caracteres**<span style="color: rgb(0, 0, 0);">) e o `value` com o valor do botão.</span></span>

#### Link

O botão `link `abre o navegador com a URL especificada.

<p class="callout warning">Não esqueça que é obrigatório o protocolo, por exemplo https://</p>

[![image.png](https://docs.dchat.com.br/uploads/images/gallery/2025-02/scaled-1680-/4phLZlzddSMOFD5W-image.png)](https://docs.dchat.com.br/uploads/images/gallery/2025-02/4phLZlzddSMOFD5W-image.png)

Sua estrutura é:

```json
{
   "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.

<p class="callout warning">A cobrança da resposta é feita em sua conta e não do cliente!</p>

[![image.png](https://docs.dchat.com.br/uploads/images/gallery/2025-02/scaled-1680-/qpPpAfji9bkf1XiS-image.png)](https://docs.dchat.com.br/uploads/images/gallery/2025-02/qpPpAfji9bkf1XiS-image.png)

Sua estrutura é:

```json
{
   "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.

<p class="callout info">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`.  
</p>

[![image.png](https://docs.dchat.com.br/uploads/images/gallery/2025-02/scaled-1680-/uTgPcusMA0qTkmww-image.png)](https://docs.dchat.com.br/uploads/images/gallery/2025-02/uTgPcusMA0qTkmww-image.png)

Sua estrutura é:

```json
{
   "type":"call",
   "title":"Título do botão",
   "value":"+5514999998877"
}
```