Pular para o conteúdo
Entrar Testar grátis

API REST · v1 oficial e v2 QR Code

Seu sistema chama. O WhatsApp entrega.

Ligue o seu ERP, CRM ou site ao WhatsApp da empresa: uma chamada HTTP envia a mensagem, e a resposta do cliente volta no seu webhook.

Ver a documentação Testar grátis
  • JSONna ida e na volta
  • Bearercom o token da empresa
  • 4linguagens nos exemplos

Exemplo: o seu sistema faz POST em /v1/mensagens/botoes, a API responde 202 aceita, o cliente recebe a pergunta com os botões Sim e Não, toca em Sim, e o evento mensagem.recebida chega no webhook do seu sistema.

O que a API faz

Tudo o que o atendimento envia, agora o seu sistema também envia.

As mesmas conexões que a sua equipe usa no painel, abertas para outro sistema chamar.

  • Mensagem de todo tipo

    Texto, imagem, documento e áudio. Na API oficial, também até 3 botões de resposta rápida e menu com até 10 opções.

    /mensagens/mensagem · midia · botoes · menu

  • Templates aprovados

    Liste os templates aprovados na Meta para a conexão, com as variáveis de cada um, e envie com um POST. É o caminho fora da janela de 24 horas.

    /mensagens/templates · template

  • Webhook com três eventos

    O cliente escreveu, a mensagem foi entregue, lida ou falhou, a conexão mudou de estado. Tudo chega no seu endereço https.

    mensagem.recebida · mensagem.status · conexao.status

  • Assinado e com nova tentativa

    Cada evento vem assinado com HMAC SHA-256. Se o seu endereço não responder 2xx, o Zapcel tenta de novo depois de 1 minuto e de 5 minutos.

    X-Zapcel-Assinatura: sha256=…

  • Um token da empresa

    Gerado no painel, em Configurações > API REST, e enviado no cabeçalho Authorization. Até 60 chamadas por minuto em cada token.

    Authorization: Bearer SEU_TOKEN

  • Recusa que explica

    Toda recusa tem a mesma forma: a frase para quem lê e a causa para quem programa. Nenhuma recusa envia mensagem pela metade.

    { "erro": "…", "causa": "…" }

Duas versões, uma forma

Uma versão para cada tipo de conexão.

O mesmo token, os mesmos campos e as mesmas respostas. O que muda é o endereço base.

OFICIAL

v1 · WhatsApp Cloud API

https://zapcel.com.br/v1

Para a conexão oficial da Meta. Texto, mídia, botões e menu saem para quem escreveu nas últimas 24 horas; fora dessa janela, o caminho é o template aprovado.

  • Info da Conexão e Webhook
  • Mensagem, Mídia, Botões e Menu
  • Listar e Enviar Templates
Ver as portas da v1
BAILEYS

v2 · Conexão por QR Code

https://zapcel.com.br/v2

Para a conexão por QR Code, que é não oficial: o número é o do aparelho, sem janela de 24 horas e sem template. Cada envio passa pelo freio de ritmo do número, que cuida do intervalo, do teto do dia e do aquecimento.

  • Info da Conexão e Webhook
  • Mensagem e Mídia
  • Botões, menu e templates ficam na v1
Ver as portas da v2

Documentação

Cada porta, pronta para rodar.

Escolha a versão e a porta. O corpo, os campos, o código em quatro linguagens e cada resposta estão aqui, com um token e uma conexão de exemplo.

Zapcel API REST
Baixar JSON v1
Tokende exemplo Conexãoos exemplos usam esta

O token está a um clique no painel.

Entre no Zapcel, abra Configurações > API REST e GERE o token da empresa. Ainda não usa o Zapcel? O teste é grátis.

Entrar no painel Testar grátis