# messages (POST)

Envia uma mensagem, incluindo botões, para um cliente. Você pode referir-se apenas pelo id do cliente. Portanto, esse cliente deve existir na lista de clientes. Caso contrário, use clients (POST) para criar um novo cliente.

Request:

![](https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2FkgUcRns1VLT1mXDL0dfs%2Fimage.png?alt=media\&token=805f9369-0eca-43ff-ab1a-bc9208ee404d)

Body do request(sem botões):

![](https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2Fu8nytSzp25nnzmHuZr3V%2Fimage.png?alt=media\&token=f8760807-2459-41c2-9d20-376876566329)

Parâmetros: 

• client\_id – id do cliente (veja clients (GET)). 

• text – texto da mensagem (necessário se não há anexo ou PDF). 

• attachment–URLpara anexo em imagem. Apenas URLs diretos são suportados. 

• pdf – URLpara anexo em PDF. Apenas URLs diretos são suportados.

Enviar coordenadas para um cliente não é suportado . 

• type: o to\_client – mensagem para o cliente (por padrão). 

o autoreply – mensagem automática para um cliente (ex: mensagens do menu. 

o system – Mensagem do sistema (não é enviada ao cliente). 

o comment – Comentário interno/mensagem interna (cliente NÃO VÊ). 

• transporte: 

o whatsapp 

o wa\_cm 

o wa\_infobip 

o viber 

o viber\_public 

o viber\_business 

o widget (live chat) 

o facebook 

o vkontakte 

o telegram 

o email 

o sms e mais – veja transports (GET) para a lista completa. 

Se omitido, transport da última mensagem do cliente será usado. 

channel\_id – veja channels (GET). Se omitido, canal da última mensagem do cliente será usado. 

• operator\_id – see operators (GET).Se omitido, a mensagem será enviada para o diálogo atual do operador. Caso especificado, a mensagem será mencionada como enviada pelo operador específico. 

• open\_dialog (true/false) – abrur ou não o diálogo ao enviar mensagem para ele. É true por padrão. 

• encrypted (true/false) New – enviar a mensagem em formato criptografado ou não. Por padrão é false. A mensagem aparece como criptografada no domínio da Chat2Desk mas é enviada para um cliente de forma normal, não criptografada.

• external\_id–caso você envie uma mensagem via integração de outro mensageiro ou sistema CRM, você pode armazenar id da mensagem em um sistema externo nesse sistema, se for necessária para a integração; 

• reply\_message\_id– se você deseja enviar uma nova mensagem que menciona uma mensagem anterior, você deve adicionar o id da mensagem inicial para esse parâmetro. 

Nova a incluirá o texto e os anexos da mensagem inicial. O texto da nova mensagem terá a seguinte aparência

![](https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2FZuTIwMm7k8I97lesMNQ5%2Fimage.png?alt=media\&token=2a1529b7-4ca8-4b40-941a-a5e3f262cb58)

Body do Request (botões):

![](https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2FxdvIkuy72kulzBC7ifnA%2Fimage.png?alt=media\&token=1457a27c-a417-4ae1-8cd5-7906692dc432)

Button que o array pode conter:

![](https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2FoN6DquEiehSkWIvQwpPx%2Fimage.png?alt=media\&token=4bd38f39-4931-457c-a045-d3e70d2a79a7)

Exemplo:

![](https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2FCnscgF1Jb01jYXuleYbZ%2Fimage.png?alt=media\&token=3480253b-edbf-4876-b383-ed4f42feda73)

Parâmetros suportados pelos mensageiros: 

• reply – VK, Viber Public, Facebook, Telegram, Live chat 

• phone – Telegram, Facebook, Viber Public 

• email – Facebook 

• location – Telegram,Facebook 

• url – Viber Public, Live chat 

• payload – Viber Public, Facebook, VK, Online chat

• color –ViberPublic,VK,Livechat Suporte a botões Inline: 

• url – Viber Public, Facebook, Telegram 

• reply – Viber Public, Facebook, Telegram 

• location, phone, email – nenhum 

Recomendamos manter botões com no máximo 38 caracteres. Caso contrário, a mensagem pode não ser enviado. 

Resposta Típica:

![](https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2FjhKZnqmvHLQOLbJ9XNhC%2Fimage.png?alt=media\&token=f1a32c80-bb42-42cf-b1de-aeff39a6faf8)