Setup e Pareamento de Instâncias WhatsApp

O Yzex Connect suporta duas modalidades seguras de pareamento de instâncias: via imagem de QR Code e via código de pareamento numérico (Pairing Code).

1. Criando uma Instância

Para iniciar o provisionamento de uma nova sessão de mensageria:

curl -X POST https://api.yzex.com.br/v1/instances \
  -H "Authorization: Bearer <SEU_TOKEN_JWT>" \
  -H "Content-Type: application/json" \
  -d '{
    "instance_name": "atendimento-principal",
    "webhook_url": "https://erp.rocketz.com.br/webhooks/yzex"
  }'

2. Conexão via QR Code

Ao solicitar o status de conexão, caso a instância esteja desvinculada, a resposta conterá a representação Base64 do QR Code atualizado:

curl -X GET https://api.yzex.com.br/v1/instances/atendimento-principal/qr \
  -H "Authorization: Bearer <SEU_TOKEN_JWT>"

Escaneie a imagem gerada através do aplicativo WhatsApp em Aparelhos Conectados → Conectar um Aparelho.

3. Conexão via Pairing Code (Alternativa)

Para integrações em que a interface não suporta renderização visual de imagens, utilize o pairing code numérico de 8 dígitos:

curl -X POST https://api.yzex.com.br/v1/instances/atendimento-principal/pairing-code \
  -H "Authorization: Bearer <SEU_TOKEN_JWT>" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "5511999998888"
  }'