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.appComo 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.
| Escopo | Libera |
|---|---|
messages:send | Enviar mensagens, reações, presença, leitura, editar e apagar (/message, /chat). |
conversations:read | Verificar números, foto de perfil, histórico e resultado de enquete. |
groups:read / groups:write | Consultar e gerenciar grupos (/group). |
webhooks:write | Configurar webhooks por instância (/webhook/set) e callbacks Z-API. |
channels:read / channels:write | Listar, 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"