SDKs e ferramentas

Não existe SDK oficial do Nexus. A API é HTTPS com JSON e um contrato OpenAPI público, o que basta para qualquer ferramenta de integração e para gerar um cliente na sua linguagem em minutos.

n8n

1. Crie uma credencial do tipo Header Auth com nome x-api-key e valor igual à chave da conta.
2. Use o nó HTTP Request com a credencial acima.
3. Para enviar mensagem: método POST, URL https://nexus.socialfy.me/api/send, corpo JSON com instanceId, to, type e message, e um cabeçalho Idempotency-Key derivado do item que originou o envio (por exemplo, o id do pedido).

Dica: antes do envio, um GET /api/wa/status/{instanceId} evita disparar numa linha desconectada.

Make

1. Módulo HTTP > Make a request.
2. Cabeçalho x-api-key com a chave da conta e Content-Type: application/json.
3. Mesmas rotas e corpos do n8n. Guarde a Idempotency-Key no cenário para repetir com segurança em caso de erro.

Código próprio

Gere um cliente a partir do contrato:

# JSON do contrato
curl -o nexus.json https://docs.socialfy.me/openapi/nexus.json

# Exemplo com openapi-generator (TypeScript)
openapi-generator-cli generate -i nexus.json -g typescript-fetch -o ./nexus-client

Qualquer gerador compatível com OpenAPI 3.1 serve. O contrato declara os esquemas de segurança (AccountApiKey, InstanceApiKey, NexusUserBearer), então o cliente gerado já sabe onde a chave entra.

Sem gerador, três linhas resolvem:

const res = await fetch('https://nexus.socialfy.me/api/wa/instances', {
  headers: { 'x-api-key': process.env.NEXUS_API_KEY! },
});
const { instances } = await res.json();

curl

Toda operação da referência tem exemplo em curl. Para explorar:

curl https://nexus.socialfy.me/api/nexus/capabilities

Essa operação é pública e mostra o catálogo de recursos por tipo de conexão, sem credencial.

Agentes de IA

Para dar a um agente acesso de leitura e reconexão segura, use o servidor MCP em vez de entregar a chave ao modelo.

O que evitar

• Colocar a chave num frontend, app móvel ou planilha compartilhada.
• Usar a sessão de uma pessoa como credencial de automação. Ela expira e carrega poder demais.
• Disparar em massa pela API. O limite que derruba a linha é o do canal, não o da API.