Onboarding: Integrando seu ERP ao Yzex Connect

Este tutorial guia o desenvolvedor através dos passos fundamentais para autenticar e realizar a primeira chamada de mensageria na API do Yzex Connect.

Pré-Requisitos

  1. Uma conta homologada no portal de parceiros Yzex.

  2. Um par de credenciais de acesso (API Key e Partner Secret).

  3. Ambiente com suporte a requisições HTTPS e JSON.

Passo 1: Obtenção de Token de Acesso

Execute uma requisição POST ao endpoint de autenticação para trocar sua API Key por um token de curta duração:

curl -X POST https://api.yzex.com.br/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "yzex_pk_live_xxxxxxxx",
    "secret": "yzex_sk_live_yyyyyyyy"
  }'

Passo 2: Verificando a Conectividade

Utilize o Bearer token retornado para consultar o status da sua organização parceira:

curl -X GET https://api.yzex.com.br/v1/partner/health \
  -H "Authorization: Bearer <SEU_TOKEN_JWT>"

Próximos Passos

Após estabelecer a comunicação básica, avance para o Setup e Pareamento de Instâncias WhatsApp ou consulte as diretrizes de Recepção de Webhooks.