Header usado em tudo:
access-tokenBase: /api/fc · Corpo sempre em JSON · número com DDI (5511999999999) · cada canal (número de WhatsApp) tem o próprio token. O botão Executar chama a API de verdade.
search
send
Envio de mensagens
Enviar texto, mídia, template e mensagens interativas pra um número ou contato. ATENÇÃO: conversa que um atendente já assumiu recusa com HTTP 409 o envio ANÔNIMO e o de cadastro marcado como robô — quem está falando manda userId de um atendente de verdade (o uuid vem de /users) e passa. Robô não escreve por cima de gente, nem quando se identifica. Pra devolver a conversa à automação, use POST /chats/{id}/release. RETORNO DOS ENVIOS: envio aceito responde 202 com { status, success, currentChatId, messageSentId, messagesSentIds, id } — messageSentId (repetido em id e em messagesSentIds) é o id da mensagem no provedor, o mesmo messageId que chega depois nos eventos do webhook. FORMATO DO ID: wamid.… no WhatsApp oficial/coexistência; id da Evolution no QR; e, em canal Instagram ou Messenger, SEMPRE com o prefixo do canal — instagram:<id da Meta> ou messenger:<id da Meta> (ex.: "instagram:aWdfZAG1faXRlbToxOk…", "messenger:m_AbCdEf…"). MUDANÇA DE 30/09/2026 (v0.53.7): até essa data o id de Instagram/Messenger saía CRU (sem prefixo) na maioria dos envios; agora o prefixo vem em todos, e é com ele que a mensagem fica gravada. Trate o id como texto opaco: guarde e compare a string inteira, sem validar formato. Se você guardou ids crus de antes da mudança e precisa casar com os novos, compare pelo que vem depois do primeiro ":" quando o id começa por instagram: ou messenger:. Mensagens enviadas antes de 30/09/2026 continuam com o id cru no histórico.chat
Conversas (chats)
Listar, abrir, consultar, transferir e finalizar atendimentos.image
Mensagens e mídia
Consultar mensagens e baixar a mídia recebida.event
Agendamento de mensagens
Programar envios pra data/hora futura.contacts
Contatos
Cadastro, consulta, bloqueio, atributos e arquivamento de contatos.sell
Etiquetas (tags)
Etiquetas do canal e vínculo com contatos.diversity_3
Grupos de WhatsApp (canal QR)
Criar e administrar grupos — só funciona com token de canal QR pareado. {jid} é o id do grupo (120363…@g.us; o @ pode ir url-encodado como %40).groups
Equipe e setores
Atendentes e setores (pra transferências e filtros).handyman
Utilidades
Verificações e informações do canal.campaign
Disparo em massa (campanhas)
Enfileirar um disparo pro canal do token e acompanhar. A fila envia em lotes por minuto com retry e pula quem pediu pra sair (opt-out).forum
Comentários (Instagram/Facebook)
Moderar comentários públicos de post e menções em story do canal (Instagram/Messenger). Comentário não é DM: ele vira conversa só quando você puxa pro privado.insert_chart
Relatórios
Números agregados do canal — a mesma conta do Dashboard de atendimentos do painel.monitor_heart
Presença do time
Quem está de fato disponível agora — a mesma régua da roleta de distribuição e do Monitoramento do painel.view_kanban
Funil de vendas (CRM)
Ler o funil kanban da empresa do canal e mover cards. Mover é um update puro (igual ao arrastar do painel) — não dispara automação nenhuma.cell_tower
Canal
Identidade do canal do token.webhook