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 (standardwebhooksno 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 substituicreated_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 pedemconfirm: true. Veja Servidor MCP. - OAuth 2.1 com PKCE, registro dinâmico de clientes e resource indicators para
/api/v1e/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.jsonpassou 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.