ZynzapAPI
Números (sessões)

Reconectar número (SSE)

Reconecta um número já pareado e transmite o progresso por SSE. Se o WhatsApp pedir novo pareamento, chega um novo qr.

Cada mensagem chega como event: message com um SessionEvent em JSON; o fim é event: end; falhas, event: error com o corpo de erro padrão. Prazo máximo do stream: 5 minutos. Limite: 10 aberturas por minuto por conta.

Permissão: sessions:manage.

POST
/sessions/resume
AuthorizationBearer <token>

Chave de API criada no painel (API e integrações). Prefixos: zz_live_, zz_test_ (e os antigos wl_live_/wl_test_).

In: header

requestResumeWaSessionRequest

Response Body

curl -N -X POST "https://api.zynzap.com.br/v1/sessions/resume" \  -H "Authorization: Bearer $ZYNZAP_API_KEY" \  -H "Content-Type: application/json" \  -d '{  "request": {    "session_id": "8c1f7a52-4d1e-4b8a-9a43-2f6f5d0c9e11"  }}'
"event: message\ndata: {\"progress\":{\"stage\":\"created\",\"session_id\":\"8c1f7a52-4d1e-4b8a-9a43-2f6f5d0c9e11\"},\"event\":\"progress\"}\n\nevent: message\ndata: {\"qr\":{\"data\":\"2@AbCdEf...\"},\"event\":\"qr\"}\n\nevent: message\ndata: {\"connected\":{\"phone\":\"5511987654321\",\"connected_at_unix_ms\":\"1760280000000\"},\"event\":\"connected\"}\n\nevent: end\ndata: {}\n"
{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "Requisição inválida para esta operação.",
    "requestId": "7f3c1a9e-2b4d-4c6e-8f10-a1b2c3d4e5f6",
    "reason": "RPC_REQUEST_INVALID"
  }
}
{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "Credencial de API ausente, inválida ou revogada.",
    "requestId": "7f3c1a9e-2b4d-4c6e-8f10-a1b2c3d4e5f6",
    "reason": "API_AUTH_REQUIRED"
  }
}
{
  "error": {
    "code": "FORBIDDEN",
    "message": "Este endereço IP não está autorizado a usar esta chave de API.",
    "requestId": "7f3c1a9e-2b4d-4c6e-8f10-a1b2c3d4e5f6",
    "reason": "API_KEY_IP_FORBIDDEN"
  }
}
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Não encontramos o recurso solicitado.",
    "requestId": "7f3c1a9e-2b4d-4c6e-8f10-a1b2c3d4e5f6"
  }
}
{
  "error": {
    "code": "CONFLICT",
    "message": "A cotação expirou. Revise os custos novamente.",
    "requestId": "7f3c1a9e-2b4d-4c6e-8f10-a1b2c3d4e5f6",
    "reason": "BILLING_QUOTE_EXPIRED"
  }
}
{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "Requisição inválida para esta operação.",
    "requestId": "7f3c1a9e-2b4d-4c6e-8f10-a1b2c3d4e5f6",
    "reason": "RPC_REQUEST_INVALID"
  }
}
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Limite de requisições desta chave atingido. Aguarde um instante.",
    "requestId": "7f3c1a9e-2b4d-4c6e-8f10-a1b2c3d4e5f6",
    "reason": "API_KEY_RATE_LIMITED"
  }
}
{
  "error": {
    "code": "UNAVAILABLE",
    "message": "Resultado incerto. Confira o estado antes de repetir a operação.",
    "requestId": "7f3c1a9e-2b4d-4c6e-8f10-a1b2c3d4e5f6",
    "reason": "OUTCOME_UNCERTAIN"
  }
}