Novidades

O que mudou na API, nos webhooks e no servidor MCP.

17 de outubro de 2026

Webhooks no padrão Standard Webhooks

  • As entregas seguem o Standard Webhooks: a chave do HMAC é a parte do segredo depois de whsec_, decodificada de base64, e as bibliotecas oficiais (standardwebhooks no npm e no PyPI) verificam as entregas. Veja Verifique a assinatura.
  • O corpo agora é { id, type, version, timestamp, organization_id, data }; timestamp é quando o evento aconteceu e substitui created_at.
  • Rotacionar chave: uma chave nova, mostrada uma vez; por 24 horas as entregas levam duas assinaturas.
  • Pausar entregas e Retomar entregas por endpoint.
  • Novas tentativas com espera exponencial a partir de 30 segundos, até 12 tentativas em 24 horas; guardamos os primeiros 500 caracteres da resposta.
  • Os access tokens OAuth também têm limite de 600 requisições por minuto, por conexão.
  • GET /v1/contacts/{id} traz as tags e os campos personalizados do contato.
  • A referência e o documento OpenAPI trazem o esquema e um exemplo da resposta de cada endpoint. Os relatórios (/v1/reports/*) passam a responder em snake_case, como o resto da API.
  • O bloco Enviar webhook envia um corpo JSON (o gatilho e o contato, ou um modelo seu), cabeçalhos opcionais e, com um segredo, a assinatura do Standard Webhooks. Veja Enviar webhook.

Servidor MCP e OAuth 2.1

  • Servidor MCP em https://app.zaplin.com.br/api/mcp: Claude, ChatGPT, Cursor e outros clientes se conectam com OAuth e agem com o papel de quem autoriza. Cada rota da API é uma ferramenta; as que apagam ou alcançam pessoas pedem confirm: true. Veja Servidor MCP.
  • OAuth 2.1 com PKCE, registro dinâmico de clientes e resource indicators para /api/v1 e /api/mcp. Apps registrados em Desenvolvedores → OAuth apps têm segredo com rotação de 24 horas e pedido de verificação; sem verificação, alcançam o workspace dono e mais 10. Veja OAuth.
  • Mais da API: editar, marcar, preencher, descadastrar e excluir contatos; tags e campos; iniciar conversas, notas internas e respostas salvas; rascunhos de automação, formulário e segmento; pausar, retomar, cancelar e desagendar campanhas; enviar um lembrete agora; remover negócios; e os relatórios de atendimento, contatos, automações, campanhas, vendas e números.
  • O documento OpenAPI em /api/v1/openapi.json passou a trazer os corpos, os filtros e a descrição de cada endpoint, e esta documentação nasce dele.

Blocos de automação

  • Agente de IA: conversa rumo a um objetivo, manda a resposta e sai pelo que aconteceu.
  • Buscar contatos: até N contatos de uma lista ou segmento, para um Para cada.
  • Marcar opt-out e Esperar até uma data do fluxo.
  • Uma automação pode começar de vários jeitos: cada gatilho inicia o seu caminho.
  • Requisição HTTP, Enviar webhook e Webhook recebido ligam as automações a outros sistemas.

Nesta página