v2PainelCriar chave

API do ConnectDM

Uma API HTTP para mandar e receber mensagens pelos números que você conectou no ConnectDM. As rotas seguem o formato da Evolution API v2, então um sistema que já usa Evolution passa a funcionar trocando só o endereço e a chave.

Base URL:https://api.connectdm.app

Como apontar para um número: nas rotas, :instance é o nome que você deu ao cadastrar o número (instanceName). Ele não muda depois, então pode ficar fixo no seu código.

Chave e acesso

Todas as requisições levam a chave de API no cabeçalho apikey (ou Authorization: Bearer). Crie chaves em Desenvolvedores › Chaves de API. Cada chave vale só para o workspace em que foi criada e para os escopos escolhidos.

EscopoLibera
messages:sendEnviar mensagens, reações, presença, leitura, editar e apagar (/message, /chat).
conversations:readVerificar números, foto de perfil, histórico e resultado de enquete.
groups:read / groups:writeConsultar e gerenciar grupos (/group).
webhooks:writeConfigurar webhooks por instância (/webhook/set) e callbacks Z-API.
channels:read / channels:writeListar, conectar, criar, desconectar e deletar instâncias (/instance). Criar respeita o limite do plano (429 acima dele).

GETTestar a chave

/instance/fetchInstances

A forma mais rápida de saber se a chave funciona: se ela for válida, a resposta lista os números do workspace.

curl -X GET https://api.connectdm.app/instance/fetchInstances \
  -H "apikey: sk_live_SUA_CHAVE"
© 2026 ConnectDM by Centralizer · Referência da API