Modos de envio
O campocalled determina se a mensagem abre um atendimento e quais campos são obrigatórios.
- Abrindo atendimento
- Sem atendimento
- Chamado existente
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 semdepartment.
Exemplo abrindo atendimento
Semcalled, 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 enviarsignMessage: false, o Hust altera o texto antes de enviar:
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:Contas Co-Ex (WABA + QR)
Contas Co-Ex (WABA + QR)
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.
Conexão master
Conexão master
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.
connection na resposta em vez de assumir a conexão que você enviou.
Resposta
Retorna200 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.
