Troubleshooting

I get 401 Unauthorized

Your request is missing a valid API key.

Check that you are sending one of these headers:

x-api-key: ck_live_your_api_key

Authorization: Bearer ck_live_your_api_key

I get 402 Payment Required

Your account has reached its monthly API hit limit.

Upgrade your plan or wait until the next billing cycle.

My message endpoint returns 403

Message sending requires a valid API key from your ChatKazi account.

The QR code is empty

Start the session first:

curl -X POST "$CHATKAZI_BASE_URL/session/start" \
  -H "x-api-key: $CHATKAZI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "sessionId": "default" }'

Then poll the QR endpoint until state becomes qr_ready.

A phone number is already connected

One WhatsApp number cannot be connected to two sessions at the same time.

Log out the old session or use a different WhatsApp number.

Messages are not sending

Confirm that:

• The session state is connected.
• The recipient phone number is in international format.
• Your account has not reached its plan limits.
• The request is made from your backend with your API key.

The default session is confusing

If sessionId is omitted, ChatKazi uses default.

For teams with multiple WhatsApp numbers, use explicit names such as sales, support, or nairobi_shop.