DesenvolvedoresAutorização
GUIA NEXUS PASSO A PASSO
Chave da linha
A credencial presa a um único chip e o que ela pode fazer.
A chave da linha (nx_live_) é a credencial de um único chip. Ela existe para automações que cuidam de um número só e não devem enxergar o resto da conta. Para integrar um sistema que trabalha com várias linhas, prefira a chave de API da conta.
O que ela alcança
| Operação | Observação |
|---|---|
GET /api/wa/status/{instanceId} | Só o chip da chave |
GET /api/nexus/instances/{publicInstanceId}/capabilities | Só o chip da chave |
POST /api/send e as demais operações de envio | O instanceId do corpo precisa ser o chip da chave; outro chip responde 403 |
| Servidor MCP | Só lista e opera o chip da chave |
Toda rota administrativa responde 403 para a chave da linha.
Como criar ou girar
- Abra o chip em Chips e entre na configuração dele.
- No bloco Chave de API, clique em Gerar (ou Girar, se já existir uma).
- Copie a chave agora. A tela mostra depois só o prefixo e os quatro últimos caracteres.
Girar invalida a chave anterior imediatamente. Troque na automação antes de girar, ou aceite a janela de indisponibilidade.
Como usar
curl https://nexus.socialfy.me/api/wa/status/comercial-sp \
-H "x-api-key: nx_live_SUA_CHAVE"O Authorization: Bearer nx_live_... também é aceito.
Diferenças para a chave da conta
| Chave da linha | Chave da conta | |
|---|---|---|
| Alcance | um chip | todas as conexões da conta |
| Escopos | fixos (estado e envio do próprio chip) | escolhidos na criação |
| Validade | sem vencimento | opcional |
| Quantas | uma por chip | até 20 ativas por conta |
| Revogação | girar (invalida a anterior) | revogar (fica no histórico) |
| Quem cria | quem configura o chip | dono ou administrador |
Quando escolher a chave da linha
- Um robô que responde um número específico e não pode ver os outros.
- Um script antigo que já usa a chave da linha e funciona.
- Um agente de IA conectado pelo MCP a uma linha só.
Em todo o resto, a chave da conta dá mais controle com menos credenciais.
Continue explorando.
Ver os tutoriais Seu próximo passo está na Central de Ajuda Nexus.