Skip to main content
A API da Zatten opera o dia a dia de um projeto: mandar mensagem para um lead, ler o histórico, mover o lead no funil, pôr tag, preencher propriedade, ligar ou desligar a IA, disparar automações e fluxos. Cada chamada age sobre um projeto, definido pela chave de API que vai no header. A configuração do projeto (colunas, tags, propriedades, automações, agente) não se muda pela API do dia a dia: isso é o template, pelo MCP ou pela API de template.

​
O básico

O endereço da API é sempre esse, mesmo quando a agência usa o painel com white-label.

​
API ou MCP?

Assistentes de IA (Claude Code, Codex) seguem regras próprias para usar a API: ler é livre, escrever pede um “sim”. Ver A API do dia a dia para agentes.

​
Mapa dos endpoints

Não existe endpoint para listar leads. A API sempre age sobre um lead que você já conhece pelo número. Para uma lista (todos os leads de uma coluna, por exemplo), use a exportação em Contatos → Exportar, que traz nome, telefone, coluna e tags. Ver Contatos.

​
Armadilhas

  • A chave escolhe o projeto. Não há parâmetro de projeto: uma chave trocada age no cliente errado sem erro nenhum.
  • A API não lista leads. Planeje a integração a partir do número do lead (vindo do seu sistema, de um webhook ou da exportação).
  • Ações pela API não são iguais às do CRM. Mover pela API não aciona “Disparar automações” da coluna, e texto pela API não pausa a IA. Cada página diz o que muda.
  • Mensagem em massa não é integração. Loop de envio derruba a qualidade do número. Use Campanhas.
  • A chave nunca vai para o navegador. Chame a API do seu servidor.

​
Para saber mais