Skip to main content
Cinco famílias: contacts, tags, topics, segments, campaigns. Campanha também exige escopos de envio dos canais (whatsapp:send, sms:send, …).
Cada escopo libera um tipo de operação em Contatos. Use só o que sua integração precisa.

​
Como enviar a chave

Recomendado
Alternativo
A API Key pertence a um workspace. Você não acessa outro workspace com a mesma chave.

​
Combinações comuns

Só ler base

contacts:read, tags:read

Sincronizar CRM

contacts:read, contacts:create, contacts:update, tags:read, tags:create

Campanhas pela API

campaigns:read, campaigns:create, campaigns:run + escopos de envio dos canais

Gestão completa

Todos os contacts:*, tags:*, topics:*, segments:*, campaigns:*
Lista de escopos vazia na criação = acesso ADMIN. Em produção, restrinja sempre.

​
Contatos (contacts:*)

Listar e buscar contato por ID.
Criar contato (telefone e/ou e-mail obrigatório).
Editar ficha, tags e campos.
Excluir contato.

​
Tags (tags:*)

Listar e buscar tag.
Criar etiqueta reutilizável.
Renomear tag.
Excluir tag.

​
Tópicos (topics:*)

Consentimento por tema de marketing (Newsletter, Promoções). Igual ao painel em Audience → Topics.
Listar e buscar tópico.
Criar tópico com slug estável.
Editar nome, descrição e opt-in padrão.
Excluir tópico.

​
Segmentos (segments:*)

Públicos com regras (tags, campos, tópicos, marketing). Inclui preview antes de campanhas.
Listar, buscar e preview (amostra paginada do público).
Criar segmento com JSON version: 1, match, rules.
Editar regras do segmento.
Excluir segmento.

​
Campanhas (campaigns:*)

Listar, buscar, estatísticas e destinatários por execução.
Criar campanha (opcionalmente com scheduledFor).
Editar campanha e cancelar (DRAFT/SCHEDULED → CANCELLED).
Excluir campanha.
Disparar agora (Run), enfileira envios nos canais da campanha.
Disparar campanha exige campaigns:run e escopos de envio de cada canal (whatsapp:send, sms:send, email:send, telegram:send) quando a fila processar mensagens.

​
Erros comuns

Verifique escopo da operação (Missing scope: contacts:read, etc.).
Plano ou limite PLAN_LIMIT_CRM. Regularize no painel.
Telefone ou e-mail já cadastrado no workspace.

​
Próximos passos