Skip to main content
Envia uma mensagem para um contato através de uma conexão ativa. Esta página cobre o envio de texto; mídia usa a mesma rota e está em Enviar mídia.

Modos de envio

O campo called determina se a mensagem abre um atendimento e quais campos são obrigatórios.
Comportamento padrão, quando você omite called. A rota procura um chamado em aberto para o contato e o reaproveita, ou cria um novo.Neste modo department é obrigatório.

Cabeçalhos

Corpo da requisição

Exemplo mínimo

O jeito mais enxuto de mandar uma mensagem de texto: sem abrir atendimento, então sem department.
Omitir called não tem o mesmo efeito — nesse caso o department volta a ser obrigatório. É preciso enviar "called": "without" explicitamente. Veja Modos de envio.

Exemplo abrindo atendimento

Sem called, a mensagem entra no fluxo de chamado e department passa a ser obrigatório:

Assinatura automática

Se a conexão estiver configurada para mostrar o nome do atendente e você não enviar signMessage: false, o Hust altera o texto antes de enviar:
O campo body da resposta já vem com o prefixo aplicado. Se a sua integração compara o texto enviado com o texto retornado, use signMessage: false.

Conexão efetivamente usada

A conexão da resposta pode ser diferente da que você informou. Dois mecanismos podem redirecionar o envio:
Quando a empresa tem uma conexão WABA e uma QR para o mesmo número, o Hust escolhe entre elas conforme a janela de 24 horas da última mensagem do contato. Não se aplica a grupos.
Com a configuração de troca de conexão ativa, o chamado e a mensagem são movidos para a conexão marcada como master da empresa.
Sempre leia connection na resposta em vez de assumir a conexão que você enviou.

Resposta

Retorna 200 com os campos da mensagem, mais o chamado e o alerta de risco.
Exemplo de resposta
O 200 significa que a mensagem foi enfileirada, não que chegou ao destinatário. Acompanhe o ack para confirmar a entrega.

Erros

Todos os erros retornam 400, inclusive falhas de validação e de autenticação de conexão.
Em CALLED_ALREADY_STARTED, o campo actions traz takeOver e os dados do chamado, permitindo que a interface ofereça a transferência do atendimento.