Perguntas frequentes

Credenciais

Quem pode criar uma chave de API da conta? O dono ou um administrador da conta, em Conta > Desenvolvedores. Membro não cria.

Onde encontro as chaves que já existem? Na mesma tela. A lista mostra nome, começo e final da chave, escopos, último uso, vencimento e situação. A chave inteira não aparece de novo.

Perdi a chave. Consigo ver de novo? Não. Revogue e crie outra.

Posso ter mais de uma chave? Sim, até 20 ativas por conta. O recomendado é uma por integração, com o nome dela.

Como mudo os escopos de uma chave? Crie uma chave nova com os escopos certos, troque na integração e revogue a antiga. Escopo não se edita.

Qual é a diferença entre nx_acct_ e nx_live_? nx_acct_ é a chave da conta: todas as linhas, com escopos. nx_live_ é a chave da linha: um chip só. Ver Autorização.

Posso usar o login de uma pessoa na automação? Pode, mas não deve. A sessão expira e tem poder demais. Use a chave da conta.

Minha chave vazou. E agora? Revogue agora, crie outra, troque na integração e revise os envios do período. Ver Chave de API da conta.

Chamadas

Recebi 403 com a chave certa. Por quê? Veja o code. ACCOUNT_API_SCOPE_REQUIRED é escopo faltando; ACCOUNT_API_ROUTE_NOT_ALLOWED é operação que não aceita chave da conta; USER_AUTH_REQUIRED é operação administrativa. Ver Erros.

O 200 garante que a mensagem chegou? Não. Garante que o pedido foi aceito. Confirme pelo estado da operação ou pelo webhook message_sent.

Deu timeout. Reenvio? Repita a mesma requisição com a mesma Idempotency-Key. Ver Limites e idempotência.

Qual é o limite de requisições por minuto? O contrato 1.0.x não define cota por requisição. O limite que importa é o do canal: volume fora do padrão de conversa derruba a linha.

Como descubro o instanceId? GET /api/wa/instances com instances:read. O instanceId é o nome dado à linha na criação.

Consigo criar linhas pela API? Sim, com sessão do painel, por POST /api/wa/instances. A chave da conta não cria linhas na versão atual.

Webhooks

Como sei que o evento veio do Nexus? Configure um segredo e valide o cabeçalho X-Nexus-Signature. Ver Webhooks.

O Nexus reenvia um evento que falhou? Na versão atual não há reentrega automática. Responda 2xx em até 5 segundos e processe em fila.

Ambiente

Existe ambiente de testes? Não há servidor de sandbox. Use uma linha de teste da própria conta e um contato de teste com consentimento.

Existe SDK oficial? Não. Gere um cliente a partir do OpenAPI ou use HTTP direto. Ver SDKs e ferramentas.

Vai ter OAuth para apps de terceiros? Está planejado. O que já está decidido e como se preparar está em Apps de terceiros.