# LinkZap — API e webhooks > Atendimento e automação no WhatsApp com IA. Tudo o que o painel faz está disponível por API (REST e MCP): contatos, conversas, mensagens, CRM, fluxos, agentes de IA, campanhas, equipe e configurações. Autenticação por chave (`lz_…`, age como quem a criou) ou por OAuth no servidor MCP. ## Para agentes de IA (comece aqui) 1. Peça ao usuário UMA credencial: no LinkZap, Configurações › Integrações › Conectar uma IA, que entrega uma chave `lz_…` pronta. Clientes MCP (claude.ai, ChatGPT) podem, em vez disso, conectar `https://linkzap.ia.br/mcp` e o usuário entra por login. 2. Confira a chave: `GET https://linkzap.ia.br/api/v1/me` com `Authorization: Bearer lz_…`. 3. Descubra as ações: `GET https://linkzap.ia.br/api/v1/actions` (ou, sem chave, `https://linkzap.ia.br/actions.json`, com o esquema de cada uma). 4. Descreva e execute: `GET /api/v1/actions/{nome}` devolve o JSON Schema da entrada; `POST /api/v1/actions/{nome}` com esse corpo executa, com as permissões de quem criou a chave. 5. Leia antes de escrever: os ids vêm das listas. Recusas vêm em português, com 422 (entrada), 403 (permissão) ou 404. Roteiro completo: https://linkzap.ia.br/developers/agents.md. Servidor MCP: https://linkzap.ia.br/mcp (ferramentas listActions, describeAction, runAction e os atalhos da API). A URL base é `https://linkzap.ia.br/api/v1`. A chave (`lz_…`) vai em `Authorization: Bearer` ou em `x-api-key`. O que volta fica dentro de `data`. O freio é de 120 chamadas por minuto por chave e 600 por organização; o 429 traz `retry-after` em segundos. Não há CORS: chame do seu servidor. ## Contrato - [OpenAPI 3.1](https://linkzap.ia.br/openapi.json): a especificação completa — rotas, campos de entrada e de saída, erros e os eventos de webhook. - [Catálogo de ações](https://linkzap.ia.br/actions.json): cada ação do painel, por área, com o JSON Schema da entrada (público). - [Referência navegável](https://linkzap.ia.br/developers/api-reference): as mesmas rotas em HTML, para conferir com um humano ao lado. ## Primeiros passos Do zero à primeira mensagem enviada por API. - [Começar](https://linkzap.ia.br/developers/start.md): O que dá para automatizar, e o caminho de três minutos até a primeira mensagem enviada pela API. - [Autenticação](https://linkzap.ia.br/developers/authentication.md): A chave lz_…, os dois escopos (a conta inteira ou um canal), como rotacionar e o que fazer se ela vazar. - [Convenções e erros](https://linkzap.ia.br/developers/conventions.md): URL base, paginação, datas, telefone, o formato dos erros e o limite de chamadas por minuto. - [Para agentes de IA](https://linkzap.ia.br/developers/agents.md): O roteiro para uma IA operar o LinkZap sozinha: que credencial pedir, como descobrir as ações e como executá-las. - [Servidor MCP](https://linkzap.ia.br/developers/mcp.md): O LinkZap como ferramenta do Claude, do ChatGPT, do Cursor ou do seu agente: a API inteira por MCP, com a mesma chave. ## Referência da API Cada rota, com os campos que entram e os que saem. - [Ações](https://linkzap.ia.br/developers/actions.md): Tudo o que o painel faz, por API: listar, descrever e executar qualquer ação, com as permissões de quem criou a chave. - [Canais](https://linkzap.ia.br/developers/channels.md): Os números conectados e o channelId que quase toda escrita pede. Comece por aqui. - [Contatos](https://linkzap.ia.br/developers/contacts.md): Listar, criar e atualizar pelo telefone, com etiquetas, campos próprios e opt-in. - [Conversas](https://linkzap.ia.br/developers/conversations.md): As conversas da caixa, com contato, canal, responsável e o estado de atendimento. - [Mensagens](https://linkzap.ia.br/developers/messages.md): Enviar texto e mídia pelo número conectado, e ler o histórico de uma conversa. - [Fluxos](https://linkzap.ia.br/developers/flows.md): Listar os fluxos e iniciar um deles para um telefone, de fora do LinkZap. - [Negócios](https://linkzap.ia.br/developers/deals.md): O funil do CRM: listar os funis e as etapas, criar negócio, mover de etapa, ganhar e perder. - [Tarefas](https://linkzap.ia.br/developers/tasks.md): As 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. - [Webhook de entrada](https://linkzap.ia.br/developers/inbound-webhook.md): Uma URL por canal: o formulário do seu site, o CRM ou o Zapier viram contato e conversa. - [Webhooks de saída](https://linkzap.ia.br/developers/webhooks.md): Receber no seu sistema tudo o que acontece aqui, assinado com HMAC. Com a verificação em Node, PHP e Python. ## Exemplos Integrações inteiras, prontas para copiar. - [Receitas](https://linkzap.ia.br/developers/recipes.md): Quatro integrações inteiras: lead do site, disparo pelo CRM, espelho da caixa e chatbot próprio. ## Conectar números Guias para ligar o WhatsApp ao LinkZap. - [API oficial com o seu app](https://linkzap.ia.br/developers/whatsapp-own-app.md): Conectar um número oficial do WhatsApp usando um app seu na Meta: as cinco chaves e onde achar cada uma. ## Optional Pode ser pulado quando o contexto é curto — é conteúdo que já está acima, noutra forma. - [Documentação inteira em markdown](https://linkzap.ia.br/llms-full.txt): todas as páginas acima concatenadas, num arquivo só. - [Índice em HTML](https://linkzap.ia.br/developers): a porta de entrada para humanos.