Pular para o conteúdo

API WaliChat + webhooks

Seu sistema envia.Sua equipe mantém o chat.

Envie mensagens, receba eventos e atribua conversas com a API WaliChat. O resultado aparece onde sua equipe já trabalha.

Acesso à API no WaliChat. Siga as regras de mensagens e os limites do seu plano.

REST API
POST /v1/messages
  1. Seu sistemaPrepare a mensagem
  2. REST APIPOST /v1/messages
  3. WaliChatVisível no chat

Seu pedido está pronto para retirada.

Requisição aceita · entrega acompanhada à parte

Um desenvolvedor independente analisa uma integração no pátio de um café.

Sua equipe vê a mensagem enviada.

Envie uma atualização do pedido

Receba um evento de entrada

Atribua o chat à Sara

Da requisição à caixa de entrada da equipe.

Três tarefas conectadas: enviar, receber e atribuir.

Deslize para ver os exemplos

Envie uma atualização do pedido

POST /v1/messages

Informe o dispositivo conectado, o destinatário e a mensagem. Use um modelo aprovado quando a API oficial exigir.

REST API
POST /v1/messages
  1. Seu sistemaPrepare a mensagem

    device + phone + message

  2. REST APIPOST /v1/messages

    Autentique com sua chave API.

  3. WaliChatVisível no chat

    Sua equipe vê a mensagem enviada.

Seu pedido está pronto para retirada.

Requisição aceita · entrega acompanhada à parte

Uma requisição aceita não garante entrega. Consulte eventos de status e gerencie erros no sistema.

Receba um evento de entrada

Posso retirar meu pedido amanhã?

Configure um webhook HTTPS e assine o evento de mensagem recebida.

Webhook

Posso retirar meu pedido amanhã?

  1. WhatsAppMensagem recebida

    O cliente escreve para o número conectado.

  2. Webhookmessage:in:new

    O evento chega ao seu endpoint HTTPS.

  3. Seu sistemaEscolha a próxima ação

    Leia, processe e decida o que fazer.

message:in:new

Webhook enviado ao endpoint configurado

Seu sistema escolhe o próximo passo. Receber um evento não envia uma resposta automaticamente.

Atribua o chat à Sara

PATCH /v1/chat/{device}/chats/{chat}/owner

Indique uma pessoa ou departamento autorizado. Departamentos dependem do plano.

REST API
PATCH /v1/chat/{device}/chats/{chat}/owner
  1. Seu sistemaEscolha quem atende

    agent / email / department

  2. REST APIPATCH …/owner

    Atualize o responsável pela conversa.

  3. WaliChatPasse o chat para Sara

    Sara continua com o contexto existente.

Conversa atribuída

Sara é responsável pelo chat

Atribuições e notas organizam a equipe; não enviam mensagens ao cliente.

Escolha a conexão para a tarefa.

Use seu sistema, um fluxo ou um cliente de IA compatível.

REST API

Leia e atualize por endpoints JSON documentados.

Webhooks

Receba os eventos configurados no seu endpoint HTTPS.

MCP

Sua IA, conectada ao negócio.

Ações API usam a autoridade da chave e os limites do plano. Regras e tarifas da Meta continuam valendo.

Consulte a referência API

Uma chave. Um teste. Seu primeiro evento.

Comece pela documentação com um número de teste conectado e revise cada resposta.

  1. Crie uma chave API

    Use uma conta autorizada para o número e guarde a chave no backend.

  2. Teste a requisição

    Use a documentação e o testador API com seus dados de teste.

  3. Gerencie eventos e erros

    Configure webhooks e confira códigos de resposta, limites e estados de entrega.

Antes de começar

  • Uma conta WaliChat com um número conectado e acesso à API.
  • Um endpoint HTTPS para os webhooks configurados.
Dois desenvolvedores trabalham com um notebook em um espaço de coworking do bairro.
Sara · WaliChat

Tenho o chat e a nota. Continuo daqui.

Quando precisa de uma pessoa, a equipe tem o chat.

Prepare a transferência para as exceções. Sua equipe vê o que aconteceu e continua com o cliente.

Veja como sua equipe trabalha

Uma conversaCom as mensagens enviadas

Uma pessoa responsávelAtribuída à pessoa certa

Suas regras de acessoFunções e acesso ao número

Antes da primeira requisição API.

Uma requisição aceita significa que foi entregue?

Não. Veja eventos de status e a resposta documentada. Seu sistema deve gerenciar falhas e novas tentativas.

O que acontece fora da janela de atendimento do WhatsApp?

A API oficial do WhatsApp mantém suas regras. Fora da janela de atendimento, use um modelo aprovado e siga as regras e tarifas aplicáveis às mensagens.

Prepare o fluxo. Continue com seu negócio.

Começar grátis

Comece com o WaliChat e escolha um plano com Flows.