Autenticação

URL base da API

https://crm.vdgestaobranding.com/api/v1

A documentação fica em developers.vdgestaobranding.com, mas todas as chamadas vão para crm.vdgestaobranding.com/api/v1.

Envie Authorization: Bearer <chave> em todas as requisições para https://crm.vdgestaobranding.com/api/v1. Owner/admin criam chaves em Configurações → API com nome, escopos, validade opcional e IPs permitidos. Guardamos só o hash; revogar tem efeito imediato. Se quem criou a chave deixar de ser owner/admin, ela para de funcionar.

curl https://crm.vdgestaobranding.com/api/v1/phone-numbers \
  -H "Authorization: Bearer $VDCRM_API_KEY"

Escopos

inbox:read — Ler conversas e mensagens

inbox:write — Enviar mensagens e gerenciar conversas

contacts:read — Ler contatos e listas

contacts:write — Criar e alterar contatos

lists:write — Criar listas e importar contatos

templates:read — Ler modelos

templates:write — Criar e excluir modelos

campaigns:read — Ler campanhas e resultados

campaigns:write — Criar e controlar campanhas

webhooks:manage — Gerenciar webhooks

flows:read — Ler fluxos e execuções

flows:write — Criar, publicar e iniciar fluxos

pipelines:read — Ler funis e negócios

pipelines:write — Criar e mover negócios

accounts:read — Ler BMs, WABAs e números

accounts:write — Sincronizar, editar perfil e conectar números

metrics:read — Ler métricas e gerar relatórios

team:manage — Gerenciar operações e equipe

settings:manage — Respostas rápidas, tags e departamentos

embed:create — Criar sessões de telas embutidas (SSO)