Skip to navigation

Usando a API para consultar templates de WhatsApp

Para consultar templates de WhatsApp usando a API é preciso utilizar a interface do sistema para gerar um
token de acesso da API.

Cumprindo esse requisito, siga os passos descritos abaixo:

1. Listar todos os templates

Este endpoint retorna todos os templates de WhatsApp cadastrados no sistema.

Exemplo de chamada:

curl -X GET "https://sua-conta.callix.com.br/api/v1/chat_outbound_templates" \
-H "Authorization: Bearer SEU_TOKEN"

Exemplo de resposta:

{
"data": [
{
"id": 1,
"type": "chat_outbound_templates",
"attributes": {
"name": "template_exemplo",
"category": "MARKETING",
"status": "approved",
"is_configured": true
}
},
{
"id": 2,
"type": "chat_outbound_templates",
"attributes": {
"name": "template_utilidade",
"category": "UTILITY",
"status": "approved",
"is_configured": true
}
}
]
}

A resposta inclui um array com todos os templates cadastrados e suas informações.

2. Consultar um template específico

Este endpoint retorna informações detalhadas de um template específico usando seu ID.

Exemplo de chamada:

curl -X GET "https://sua-conta.callix.com.br/api/v1/chat_outbound_templates/1" \
-H "Authorization: Bearer SEU_TOKEN"

Exemplo de resposta:

{
"data": {
"id": 1,
"type": "chat_outbound_templates",
"attributes": {
"name": "template_exemplo",
"category": "MARKETING",
"status": "approved",
"is_configured": true
}
}
}

Atributos

AtributoTipoDescrição
namestringNome do template
categoryenumCategoria do template (veja tabela abaixo)
statusenumStatus do template (veja tabela abaixo)
is_configuredbooleanDefine se o template está configurado

Valores possíveis para category:

ValorDescrição
UTILITYUtilidade
MARKETINGMarketing
AUTHENTICATIONAutenticação

Valores possíveis para status:

ValorDescrição
in_analysisEm análise
approvedAprovado
disapprovedReprovado
in_appealEm apelação
pending_deletionExclusão pendente
deletedExcluído no provedor
disabledInativo
pausedPausado
limit_exceededLimite excedido
errorErro

Apenas templates com status approved (aprovado) podem ser utilizados para envio de mensagens.