Skip to main content
O PanÐá Zap oferece uma API REST para integração com CRMs, ERPs, plataformas de e-commerce e ferramentas de automação. Através dela você pode enviar e receber mensagens, abrir e atualizar tickets, gerenciar contatos, executar campanhas, consultar análises e muito mais — tudo a partir de qualquer sistema externo.

​
URL Base

Todas as rotas da API seguem este padrão:

​
Autenticação

Toda requisição deve incluir um token Bearer no cabeçalho Authorization:
Gere seu token em Configurações → API → + Nova API. Consulte a página de Autenticação para instruções completas de configuração.

​
Formato da Resposta

Todas as respostas de sucesso retornam um envelope consistente:
Erros retornam:

​
Códigos de Status HTTP

​
Códigos de Erro Comuns

  • ERR_TICKET_CLOSED — O ticket de destino está fechado. Envie "reopen": true no corpo da sua requisição para reabri-lo antes de enviar.
  • ERR_NUMBER_AMBIGUOUS — Uma busca de contato por número de telefone retornou vários candidatos. Desambigue usando um ID de ticket ou ID de contato.

​
Limites e Restrições

  • Corpo JSON com conteúdo base64: até 50 MB por requisição.
  • mediaUrl: deve usar http ou https, não pode redirecionar, e hosts internos/privados são bloqueados.
  • Mesclagem de contatos: até 150 pares por requisição.
  • Limite de taxa: não há limite de taxa nas rotas externas. Use o campo externalKey para deduplicar tentativas e evitar operações duplicadas.

​
Recursos Disponíveis

Mensagens

Envie mensagens de texto, arquivos e áudio por número de telefone.

Enviar por Ticket

Envie mensagens via ID de ticket em qualquer canal conectado.

Envio em Massa

Dispare mensagens em massa para listas de contatos.

Tickets

Crie, atualize e consulte tickets de atendimento.

Contatos

Gerenciamento de contatos do CRM — criar, atualizar, mesclar e buscar.

Campanhas

Gerencie todo o ciclo de vida das campanhas.

CRM

Pipelines, oportunidades e agendamentos.

Métricas do Dashboard

Consulte contagens de tickets e análises de tempo de resposta para um intervalo de datas.

Webhooks

Receba eventos em tempo real do PanÐá Zap.