WhatsApp Alternative

Create WhatsApp Alternative session

Create a session and start the bridge. The QR is generated asynchronously: poll GET /v1/whatsapp-alt/sessions/{sessionId} until status is qr_ready and qrCode is present, then scan it from the phone (WhatsApp → Linked devices → Link a device).

The session routes through an egress from the first QR. It defaults to the managed Zavu proxy (egress.kind = external); pass egress to override. Direct (server IP) egress is not supported. Not available with test-mode API keys.

POST

whatsapp-alt

sessions

curl --request POST \
  --url https://api.zavu.dev/v1/whatsapp-alt/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "displayName": "Support line"
}
'

{
  "session": {
    "id": "jd7x2k3m4n5p6q7r8s9t0",
    "egress": {
      "nodeId": "<string>",
      "country": "cl"
    },
    "createdAt": "2023-11-07T05:31:56Z",
    "displayName": "<string>",
    "qrCode": "<string>",
    "phoneNumber": "+56912345678",
    "pushName": "<string>",
    "senderId": "<string>",
    "lastError": "<string>",
    "lastConnectedAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z"
  }
}

{
  "code": "invalid_request",
  "message": "Phone number is invalid",
  "details": {}
}

{
  "code": "invalid_request",
  "message": "Phone number is invalid",
  "details": {}
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

displayName

string

Optional label for the session.

Maximum string length: 200

egress

object

Egress to set on a session. Only external (managed Zavu proxy) and android (a customer device) are accepted — direct is a guaranteed ban and is rejected.

Show child attributes

Response

Session created.

session

object

required

Show child attributes

List WhatsApp Alternative sessions

Get WhatsApp Alternative session

⌘I

curl --request POST \
  --url https://api.zavu.dev/v1/whatsapp-alt/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "displayName": "Support line"
}
'

{
  "session": {
    "id": "jd7x2k3m4n5p6q7r8s9t0",
    "egress": {
      "nodeId": "<string>",
      "country": "cl"
    },
    "createdAt": "2023-11-07T05:31:56Z",
    "displayName": "<string>",
    "qrCode": "<string>",
    "phoneNumber": "+56912345678",
    "pushName": "<string>",
    "senderId": "<string>",
    "lastError": "<string>",
    "lastConnectedAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z"
  }
}

{
  "code": "invalid_request",
  "message": "Phone number is invalid",
  "details": {}
}

{
  "code": "invalid_request",
  "message": "Phone number is invalid",
  "details": {}
}