Skip to main content

Conectar uma Instância

Ao criar uma instância, é necessário conectá-la para começar a enviar e receber mensagens através da LiteZap API. O processo de conexão é similar ao do WhatsApp Web, e aqui vamos mostrar como fazer isso de forma simples e rápida.

Passo 1: Preparar para Conectar​

Antes de começar, tenha em mãos o instanceName e o token da instância, que são obtidos no painel LiteZap.

Passo 2: Conectar usando o Endpoint​

A conexão é feita através de uma chamada GET ao endpoint a seguir:

GET https://api.litezap.com/instance/connect/{instanceName}

Substitua {instanceName} pelo nome da instância que deseja conectar.

Headers da Requisição:​

  • X-API-Key: {token_da_instancia}

Exemplo:​

X-API-Key: 123abc

Como Conectar:​

  1. Pelo Painel de Administrador da LiteZap: Basta seguir as instruções no painel.
  2. Pela API: Integre a funcionalidade diretamente em sua aplicação usando este método.

Atenção ao QRCode:​

  • O WhatsApp invalida o QRCode a cada 20 segundos.
  • Chame este método em intervalos entre 10 e 20 segundos para obter um novo QRCode.
  • Se o usuário não ler o QRCode após 3 chamadas, interrompa o fluxo e peça a interação do usuário para evitar chamadas desnecessárias à API do WhatsApp.

Respostas Possíveis:​

  • 200: Instância conectada com sucesso.
  • 404: Instância não encontrada.

Resposta do Corpo:​

{
  "pairingCode": "string or null",
  "code": "string",
  "base64": "string"
}
  • pairingCode: Código de pareamento. Se nulo, não há código disponível.
  • code: Código para conectar o número à API sem a necessidade de leitura de QRCode.
  • base64: Bytes do QRCode em Base64, que podem ser renderizados em um componente QRCode compatível com sua linguagem de programação.

Próximos Passos​

Uma vez conectado, você está pronto para explorar todas as funcionalidades da LiteZap API! Consulte a Referência da API para obter mais detalhes sobre os métodos disponíveis.