Para desenvolvedores
A API e os webhooks do LinkZap
Envie mensagens pelo WhatsApp a partir do seu sistema, receba cada evento assinado no seu servidor e ligue o atendimento ao que a sua empresa já usa. Sem SDK obrigatório, sem OAuth: uma chave num cabeçalho.
A primeira chamada
Crie uma chave em Configurações → Integrações, e confira que ela vale. A resposta diz de qual organização ela é e se alcança a conta inteira ou um número só.
curl https://linkzap.orion.moe/api/v1/me \
-H "Authorization: Bearer lz_SUA_CHAVE"O passo a passo inteiro, até a mensagem chegar no WhatsApp, está em Começar.
São três caminhos
A API que você chama
Mandar mensagem, criar contato, ler conversa, iniciar um fluxo — do seu backend.
Ver a referênciaOs webhooks que nós chamamos
Cada mensagem recebida e cada conversa resolvida vira um POST assinado no seu servidor.
Como assinar e verificarO atalho sem código
Uma URL por número: formulário, Zapier, Make ou CRM viram contato e conversa.
Webhook de entrada
Para máquinas
Esta documentação é servida também em formatos que um gerador de cliente ou um modelo de linguagem consome direto — todos derivados da mesma fonte das páginas que você está lendo.
- OpenAPI 3.1A especificação completa — gerada das mesmas validações que as rotas usam.
- Referência navegávelTodas as rotas numa página, com campos, erros e exemplos.
- llms.txtO índice no padrão llmstxt.org, para apontar um agente a esta documentação.
- Tudo em markdownA documentação inteira num arquivo, pronta para colar num contexto.
Todas as páginas
Primeiros passos
Do zero à primeira mensagem enviada por API.
- ComeçarO que dá para automatizar, e o caminho de três minutos até a primeira mensagem enviada pela API.
- AutenticaçãoA chave lz_…, os dois escopos (a conta inteira ou um canal), como rotacionar e o que fazer se ela vazar.
- Convenções e errosURL base, paginação, datas, telefone, o formato dos erros e o limite de chamadas por minuto.
Referência da API
Cada rota, com os campos que entram e os que saem.
- CanaisOs números conectados e o channelId que quase toda escrita pede. Comece por aqui.
- ContatosListar, criar e atualizar pelo telefone, com etiquetas, campos próprios e opt-in.
- ConversasAs conversas da caixa, com contato, canal, responsável e o estado de atendimento.
- MensagensEnviar texto e mídia pelo número conectado, e ler o histórico de uma conversa.
- FluxosListar os fluxos e iniciar um deles para um telefone, de fora do LinkZap.
- NegóciosO funil do CRM: listar os funis e as etapas, criar negócio, mover de etapa, ganhar e perder.
- TarefasAs tarefas da equipe: listar, criar com prazo e responsável, concluir e reabrir.
Webhooks
Os dois sentidos: o que você nos manda e o que nós te mandamos.
Exemplos
Integrações inteiras, prontas para copiar.
Conectar números
Guias para ligar o WhatsApp ao LinkZap.