Send Typing

POST /typing

This endpoint sends a presence update (whatever the proper name is, lol): the "typing…" or "recording audio…" indicator in the recipient's chat. It makes your bot feel more human instead of replying out of nowhere.

The indicator shows for 5 seconds, then disappears on its own.

Endpoint Details

• Base URL: https://api-zawa.azickri.com
• Headers: id, session-id, and Content-Type: application/json
• Requires: a connected session (isConnected: true)

Headers

Header	Type	Required	Description
id	string	Yes	The id from Create Session.
session-id	string	Yes	The sessionId from Create Session.

Request Body

Field	Type	Required	Description
phone	string	One of*	Recipient number in international format, e.g. 6281234567890.
group	string	One of*	Group ID, e.g. [email protected].
type	string	No	text for "typing…" (default), audio for "recording audio…".

* Fill in either phone or group. If both are set, group is used.

Example Request

cURL

curl -X POST "https://api-zawa.azickri.com/typing" \
  -H "id: YOUR_ID" \
  -H "session-id: YOUR_SESSION_ID" \
  -H "Content-Type: application/json" \
  -d '{"phone":"6281234567890","type":"text"}'

Axios

import axios from 'axios';

const response = await axios.post(
  'https://api-zawa.azickri.com/typing',
  {
    phone: '6281234567890',
    type: 'text',
  },
  {
    headers: {
      'id': 'YOUR_ID',
      'session-id': 'YOUR_SESSION_ID',
    },
  },
);

console.log(response.data);

Fetch

const response = await fetch('https://api-zawa.azickri.com/typing', {
  method: 'POST',
  headers: {
    'id': 'YOUR_ID',
    'session-id': 'YOUR_SESSION_ID',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    phone: '6281234567890',
    type: 'text',
  }),
});

const data = await response.json();
console.log(data);

Response

200

{
  "id": "68b3f0a2c1d4e5f6a7b8c9d0"
}

400

// No recipient
{
  "statusCode": 400,
  "message": "invalid phone or group"
}

// Missing headers
{
  "statusCode": 400,
  "message": "invalid header"
}

404

{
  "statusCode": 404,
  "message": "session not found"
}

500

{
  "statusCode": 500,
  "message": "session not connected"
}

Field	Type	Description
id	string	The ID of the session that sent the indicator. This is not a message ID.

Recipe: Reply Like a Human

Pair it with Send Message so your bot's replies don't feel robotic:

const BASE_URL = 'https://api-zawa.azickri.com';
const headers = {
  'id': 'YOUR_ID',
  'session-id': 'YOUR_SESSION_ID',
  'Content-Type': 'application/json',
};
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

async function replyLikeHuman(phone, text) {
  // 1. Show "typing…"
  await fetch(`${BASE_URL}/typing`, {
    method: 'POST',
    headers,
    body: JSON.stringify({ phone, type: 'text' }),
  });

  // 2. Pretend to think for a moment (5 seconds at most, matching the indicator)
  await sleep(Math.min(5000, 1000 + text.length * 50));

  // 3. Send the message
  await fetch(`${BASE_URL}/message`, {
    method: 'POST',
    headers,
    body: JSON.stringify({ phone, type: 'text', text }),
  });
}

await replyLikeHuman('6281234567890', 'Got it, your order is being processed! 🙌');