ALTU
Search…
Outbound Infobip
Ao habilitar a API de outbound é gerado um endpoint e um token, que serão utilizados para realizar o envio das mensagens de outbound.

Request

Endpoint:
POST https://outbound.ms.altubots.com/infobip/<slug>/<id_integracao>
Header:
Content-type: "application/json" Authorization: "<altu token>"
1
{
2
"destination": "numero_whatsapp_destino",
3
"templateName": "nome_template",
4
"context": {
5
"status": "aprovado"
6
},
7
"templateData": [
8
"<template_dado_1>",
9
"<template_dado_2>",
10
"...",
11
"<template_dado_n>"
12
],
13
"language": "idioma_template",
14
"external_id": "seu_id_mensagem",
15
"restartContact": false | true,
16
"inactivityTime": 0
17
}
Copied!

Atributos:

  • destination: o número de WhatsApp que irá receber a mensagem
  • templateName: o nome do template
  • context (opcional): variáveis que serão salvas no contexto do usuário
  • templateData: lista de valores (strings) de parâmetros do template ordenados conforme registrados
  • language: o código do idioma ou localidade a ser usado. Precisa ser exatamente o código com o qual o template foi registrado
  • external_id (opcional): identificador único para a mensagem a ser enviada. Este id será retornado nos status de envio em seu webhook de status
  • restartContact (opcional): booleano para resetar as variáveis de contexto do usuário e reiniciar o atendimento
  • inactivityTime (opcional): tempo em minutos que deve ter passado desde a última interação do usuário com o assistente para que a mensagem seja enviada. Exemplo: Se o usuário está interagindo ou interagiu com assistente há 1 minuto e o tempo de inatividade necessário para a mensagem ser enviada é de 2 minutos ("inactivityTime": 2), a mensagem não será enviada. Caso a última interação ocorreu a mais de 2 minutos atrás, a mensagem será enviada

Exemplo

1
{
2
"destination": "35988001234",
3
"templateName": "template_fatura_total",
4
"templateData": [
5
"Maria",
6
"R$ 1670,00"
7
],
8
"language": "pt_BR",
9
"external_id": "meu_id_1"
10
}
Copied!

Response

Status 200 (OK)
Status 400 (Bad Request)
Status 401 (Unauthorized)
500 (Internal Server Error)
A mensagem foi enviada corretamente para a Infobip e será encaminhada para o usuário.Body (exemplo):
1
{
2
"status": "sent",
3
"external_id": "meu_id_1",
4
"message_id": 166,
5
"contact_id": 765
6
}
Copied!
  • status: status da mensagem enviada
  • external_id: id externo da mensagem enviada
  • message_id: id da mensagem enviada no ALTU
  • contact_id: id do atendimento do usuário no ALTU
Um ou mais parâmetros não estão no formato esperado ou parâmetros obrigatórios não foram preenchidos. Verifique o formato e obrigatoriedade de todos os parâmetros durante a requisição.Body (exemplo):
1
{
2
"status": "error",
3
"message": "Invalid destination!"
4
}
Copied!
Não foi possível autorizar a requisição. Verifique se foi definido o header Authorization com o valor token altu corretamente.Body (exemplo):
1
{
2
"status": "error",
3
"message": "Unauthorized"
4
}
Copied!
Houve um erro durante o envio da mensagem.Body (exemplo):
1
{
2
"status": "error",
3
"message": "Unexpected error"
4
}
Copied!