Instancia

Conectar instância ao WhatsApp

POSThttps://api.nodinfra.com.br/instance/connect

URL completa: https://api.nodinfra.com.br/instance/connect

Inicia o processo de conexão de uma instância ao WhatsApp. Este endpoint:

Requer o token de autenticação da instância
Recebe o número de telefone associado à conta WhatsApp
Gera um QR code caso não passe o campo phone
Ou Gera código de pareamento se passar o o campo phone
Atualiza o status da instância para "connecting"

O processo de conexão permanece pendente até que:

O QR code seja escaneado no WhatsApp do celular, ou
O código de pareamento seja usado no WhatsApp
Timeout de 2 minutos para QRCode seja atingido ou 5 minutos para o código de pareamento

Use o endpoint /instance/status para monitorar o progresso da conexão.

Estados possíveis da instância:

disconnected: Desconectado do WhatsApp
connecting: Em processo de conexão
connected: Conectado e autenticado
hibernated: Sessão pausada, com credenciais preservadas para reconexão

Sincronização e armazenamento de mensagens:

Todas as mensagens recebidas da Meta durante a sincronização da conexão (leitura do QR code) são enviadas no evento history do webhook.
As mensagens dos últimos 7 dias são armazenadas no banco de dados e ficam acessíveis pelos endpoints: POST /message/find e POST /chat/find.
Depois que a instância conecta, todas as mensagens enviadas ou recebidas são armazenadas no banco de dados.
Mensagens mais antigas do que 7 dias são excluídas durante a madrugada.

Proxy regional:

No momento, o proxy regional público está disponível para Brasil (br).
Use GET /proxy-managed/cities?country=br para listar cidades brasileiras.
Envie proxy_managed_city com o value retornado pela cidade.
Quando a cidade retornar state, envie também proxy_managed_state com esse valor.
O backend valida a combinação de país, estado e cidade antes de salvar.

Corpo da requisição

phonestringopcional

Número de telefone no formato internacional (ex: 5511999999999). Se informado, gera código de pareamento. Se omitido, gera QR code.

exemplo: 5511999999999

browserstringopcional

Browser usado no ciclo de autenticação/conexão. `auto` preserva um perfil válido já salvo ou escolhe Safari, Firefox ou Edge para novas conexões.

valores:autosafarifirefoxedgechrome

exemplo: auto

systemNamestringopcional

Sistema/nome exibido no celular em aparelhos conectados. Ajuda a identificar a instância no WhatsApp; para maior estabilidade, recomendamos deixar em branco e usar o valor padrão do navegador escolhido.

exemplo: Minha Empresa

proxy_managed_countrystringopcional

País desejado para o proxy regional, em ISO alpha-2 minúsculo. No momento, use `br`.

exemplo: br

proxy_managed_statestringopcional

Estado/subdivisão da cidade escolhida. Quando o país/cidade exigir desambiguação, use o campo `state` retornado por `GET /proxy-managed/cities?country=br`.

exemplo: sp

proxy_managed_citystringopcional

Cidade escolhida para o proxy regional. Use sempre o campo `value` retornado por `GET /proxy-managed/cities`.

exemplo: campinas

Exemplo

QR code com proxy regional em Campinas/SP

{
  "browser": "auto",
  "systemName": "Minha Empresa",
  "proxy_managed_country": "br",
  "proxy_managed_state": "sp",
  "proxy_managed_city": "campinas"
}

Respostas

200Sucesso

401Token inválido/expirado

404Instância não encontrada

429Limite de conexões simultâneas atingido

500Erro interno

503Capacidade de conexão temporariamente indisponível

curl -X POST 'https://api.nodinfra.com.br/instance/connect' \ -H 'token: SEU_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ "browser": "auto", "systemName": "Minha Empresa", "proxy_managed_country": "br", "proxy_managed_state": "sp", "proxy_managed_city": "campinas" }'