Pular para o conteúdo
Developers

Changelog

Mudanças na API, nos webhooks e no servidor MCP. Mudanças que quebram compatibilidade, quando necessárias, virão numa nova versão da URL (ex.: /v2), com aviso prévio.

v1.1.0 — 11/11/2026

Seção intitulada “v1.1.0 — 11/11/2026”

A API passa a cobrir 47 operações (eram 22). Nada mudou de forma incompatível: integrações da v1.0.0 continuam funcionando.

  • Conexões de WhatsApp pela API: crie um canal e receba o QR Code (POST /channels), acompanhe a leitura (GET /channels/{channel_id}/qr), conecte sem câmera com código de pareamento (POST /channels/{channel_id}/connect com phone), reconecte, renomeie (PATCH), desconecte (POST /channels/{channel_id}/disconnect) e remova (DELETE). Criar canais respeita o limite de conexões do plano (422 limit_reached). Veja Canais e conexões.
  • Ações de mensagem: editar o texto de mensagens enviadas em até 15 minutos (PATCH /messages/{message_id}), apagar para todos em até 48 horas ou só no painel (DELETE /messages/{message_id}?scope=everyone|me) e reagir com emoji (POST /messages/{message_id}/reaction). O objeto mensagem ganhou o campo reaction.
  • Grupos: GET /groups e GET /groups/{group_id}/participants. O id do grupo funciona como contact_id, inclusive para enviar mensagens para o grupo com POST /messages.
  • Equipe e atribuição: GET /members e GET /members/{member_id}; atribua conversas com assigned_to em PATCH /contacts/{contact_id} e filtre com GET /contacts?assigned_to=<id>|none.
  • Contatos: novos campos ai_agent_id e pinned; PATCH aceita assigned_to, pinned e ai_agent_id; novos filtros is_group e assigned_to; novo POST /contacts/{contact_id}/read para marcar a conversa como lida.
  • Agentes de IA: GET /ai-agents, GET /ai-agents/{agent_id} e PATCH /ai-agents/{agent_id} para ligar ou desligar.
  • Templates e campanhas (WhatsApp Oficial): GET /templates, POST /campaigns/quote, POST /campaigns (com aprovação da TopTalking), GET /campaigns, GET /campaigns/{campaign_id}, GET /campaigns/{campaign_id}/recipients, POST /campaigns/{campaign_id}/pause e /resume. Veja Campanhas.
  • Webhooks: novos eventos channel.status_updated (um WhatsApp conectou, caiu ou foi desconectado) e campaign.status_updated (mudança de status de campanha).
  • Erros: os códigos 503 service_unavailable e 504 timeout passam a ser documentados; limit_reached também vale para o limite de conexões do plano.
  • Servidor MCP: 18 ferramentas (eram 12). Novas: get_channel_qr (mostra o QR Code como imagem), list_groups, list_members, list_ai_agents, list_templates e list_campaigns; update_contact aceita assigned_to, pinned e ai_agent_id.

v1.0.0 — 11/11/2026

Seção intitulada “v1.0.0 — 11/11/2026”

Lançamento da plataforma para desenvolvedores da TopTalking.

  • API REST em https://platform.toptalking.com.br/v1: conta (/me), canais, contatos (com upsert pelo telefone), histórico de conversas, envio de mensagens com texto e mídia, etapas do Kanban, mensagens agendadas (Agenda) e gestão de webhooks.
  • Chaves de API no painel (Configurações → Desenvolvedor): acesso total ou somente leitura, validade opcional e revogação. Disponível em todos os planos.
  • Webhooks assinados com HMAC-SHA256: message.received, message.sent, message.status_updated, contact.created, contact.updated, contact.stage_changed, scheduled_message.sent, scheduled_message.failed e ping, com retentativas e histórico de entregas.
  • Servidor MCP em https://platform.toptalking.com.br/mcp com 12 ferramentas para Claude, Cursor, VS Code e Windsurf.
  • Documentação para IAs: /llms.txt, /llms-full.txt, /llms-small.txt e o contrato /openapi.yaml.