Pular para o conteúdo

Mudanças

  • POST /v1/inbound-submissions: registra a conversão de uma pessoa que pediu contato (formulário do site, landing, app). Segue o caminho de um formulário do Preflow: MQL por padrão ("qualified": false para só contato), respostas no lead, atribuição (UTM, campanha, página, cookies da Meta), cadência de Inbound. Lead perdido, ganho, arquivado ou já em atendimento só ganha o registro. form_id aplica as regras de MQL de um formulário do Preflow. submission_id único no workspace. Limite de 120 por minuto por chave. Guia em Receber leads do seu site.
  • GET /v1/inbound-submissions/{id}.
  • Webhook inbound.submission_received.
  • O catálogo de tipos de evento no OpenAPI (WebhookEventTypeName) passa a listar os eventos de lead, conta e reunião, que já existiam.
  • GET /v1/whatsapp/senders, GET /v1/whatsapp/templates, GET /v1/whatsapp/window.
  • POST /v1/files (upload por URL assinada, até 16 MB).
  • POST /v1/whatsapp/messages (texto, template aprovado ou mídia, para telefone ou lead), GET /v1/whatsapp/messages/{id} (status de entrega), GET /v1/whatsapp/messages?to= (histórico) e GET /v1/whatsapp/messages/{id}/media.
  • Linha padrão por chave, escolhida na tela de chaves.
  • Endpoints de webhook (até 10 por workspace) com acesso webhooks:manage: cadastro, edição, desligar/religar, exclusão, segredo novo (o anterior vale mais 24 h), teste, log de entregas de 30 dias e reenvio.
  • Eventos whatsapp.message.received, whatsapp.message.sent, whatsapp.message.status_updated e whatsapp.template.status_updated, assinados no padrão Standard Webhooks, entregues pelo menos uma vez com novas tentativas por cerca de 2 dias. Guia em Webhooks.
  • GET /v1/event-types e GET /v1/events/{id}.
  • Assinar ou ler um tipo de evento exige também o acesso de leitura do módulo dele (whatsapp:read, leads:read, accounts:read, meetings:read).
  • Reenvio recusa a entrega que já deu certo e aceita até 10 por minuto por endpoint; falha antes da conexão TLS aparece só como dns_or_address_refused.
  • Chaves secretas por workspace (pf_live_ / pf_test_), com acessos (escopos), criadas e revogadas em Configurações → Integrações → API e webhooks.
  • Só administrador ou dono do workspace cria e revoga chave; a chave cai quando quem a criou deixa de ser administrador.
  • GET /v1/me e GET /v1/openapi.json.
  • Idempotência em toda escrita, limite de 600 pedidos por minuto por chave e formato único de erro.

v1 — leads, contas, funis, cadências e reuniões

Seção intitulada “v1 — leads, contas, funis, cadências e reuniões”
  • POST /v1/leads: cria lead que entra como inbound e segue a configuração de Inbound do workspace. Aceita lead só com telefone; external_id único por workspace.
  • GET /v1/leads, GET /v1/leads/{id} e GET /v1/leads/{id}/activities.
  • GET /v1/accounts, GET /v1/accounts/{id} e GET /v1/funnels.
  • GET /v1/cadences, POST /v1/leads/{id}/cadence-enrollments e POST /v1/leads/{id}/cadence-stop.
  • GET /v1/meetings e GET /v1/meetings/{id}.