Skip to main content
O WhatsApp Oficial usa a Meta Cloud API para enviar e receber mensagens. Ao contrário de soluções não-oficiais, ele exige uma conta Business verificada pela Meta e segue as políticas da plataforma — incluindo a janela de 24 horas e o uso obrigatório de templates HSM para contatos inativos. No Tivar, o canal é identificado pelo valor "whatsapp-official".

​
Conectar o WhatsApp Oficial

1

Acesse as integrações

No painel do Tivar, vá em Configurações → Integrações.
2

Adicione uma nova integração

Clique em Adicionar integração e selecione WhatsApp Oficial.
3

Autorize via Meta

Siga as instruções na tela para conectar sua conta do Meta Business Manager e autorizar o Tivar a enviar mensagens pelo número escolhido.
4

Confirme a conexão

Após a autorização, o número aparece como Conectado na lista de integrações. Copie o integrationId caso precise direcionar mensagens para um número específico.

​
Enviar mensagens de texto

Dentro da janela de 24 horas após a última interação do cliente, você pode enviar mensagens de texto livres usando POST /api/v1/send-message com channel: "whatsapp-official". O Tivar cria o contato e a conversa automaticamente se ainda não existirem.
A janela de 24 horas é contada a partir da última mensagem enviada pelo cliente. Se o cliente não interagir nesse período, a Meta bloqueia o envio de texto livre e a API retorna o código de erro 131047 com "requires_template": true. Nesse caso, você deve usar /api/v1/send-template com um template HSM aprovado.
curl -X POST https://<seu-dominio>/api/v1/send-message \
  -H "Authorization: Bearer sk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "5511999998888",
    "message": "Olá! Seu pedido foi confirmado.",
    "channel": "whatsapp-official"
  }'

​
Enviar templates HSM

Quando a janela de 24 horas tiver expirado — ou quando você quiser iniciar uma conversa de forma proativa —, use POST /api/v1/send-template. Passe o templateName com o nome exato do template cadastrado no Meta Business Manager e um array variables com os valores que substituem {{1}}, {{2}} etc., na ordem em que aparecem no template. 
curl -X POST https://<seu-dominio>/api/v1/send-template \
  -H "Authorization: Bearer sk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "5511999998888",
    "channel": "whatsapp-official",
    "templateName": "confirmacao_pedido",
    "language": "pt_BR",
    "variables": ["João", "Pedido #1234", "R$ 150,00"]
  }'

​
Erro 131047: janela de 24h expirada

Se a API retornar o erro 131047, significa que a janela de 24 horas se encerrou. O corpo da resposta inclui "requires_template": true como sinal explícito. Troque a chamada de /api/v1/send-message por /api/v1/send-template com um template aprovado.

​
Aprovar templates HSM

O Tivar não gerencia a aprovação de templates. Você precisa criar e submeter os templates diretamente pelo Meta Business Manager. Após a aprovação, use o nome exato do template no campo templateName da requisição.