Groups and receipts
Retrieve the internal group ID from GET groups. The ID used in API paths is a Jawib identifier, rather than a WhatsApp group JID. Enable group_inbox_enabled before reading group content, media, or participant receipts.
Replies and mentions
Set reply_to to a retained WhatsApp message_id from the same chat. For mentions, provide member JIDs in mentions, using a phone-based JID or LID returned by WhatsApp. Jawib validates group membership where available.
{
"type": "text",
"text": "Confirmed. Thank you!",
"reply_to": "WHATSAPP_MESSAGE_ID",
"mentions": ["249900000000@s.whatsapp.net"]
}
Reactions
Send a reaction through the same group-message endpoint. Use an empty string or null for emoji to remove your number's reaction:
{
"type": "reaction",
"reaction_to": "WHATSAPP_MESSAGE_ID",
"emoji": "👍"
}Replies and reactions require the relevant content-read scope and enabled capture. The original message must be retained and unexpired in the same chat.
Participant receipts
The receipt endpoint reports observed delivery, read, and playback events per participant, according to the message type and events received from WhatsApp. meta.complete is always false: results are observations, not a complete membership-wide delivery guarantee.
An absent read receipt does not prove that a participant has not read the message. Jawib cannot force WhatsApp to provide an unavailable receipt. A successful send does not mean that every group member received it.
Use signed group.message.receipt webhooks for updates to existing participant rows. Maintain separate cursors for each group's message history.
Group media downloads
GET /api/v2/groups/{group}/messages/{groupMessage}/media
Authorization: Bearer JAWIB_API_KEYRequires groups:media:read and returns a file. Download it through your backend. Group sending supports text, image, audio, video, document, and reaction messages; OTP is not supported.
List groups
curl --request GET "https://playjawib.com/api/v2/groups" \
--header "Authorization: Bearer $JAWIB_API_KEY" \
--header 'Accept: application/json'use Illuminate\Support\Facades\Http;
$response = Http::acceptJson()
->withToken(env('JAWIB_API_KEY'))
->send('GET', 'https://playjawib.com/api/v2/groups');
$data = $response->throw()->json();// Run in your server, e.g. Node.js. Never expose the token in browser code.
const response = await fetch('https://playjawib.com/api/v2/groups', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.JAWIB_API_KEY}`,
Accept: 'application/json'
}
});
const data = await response.json();
if (!response.ok) throw new Error(data.message ?? 'Request failed');{
"data": [],
"meta": {
"current_page": 1,
"last_page": 1,
"total": 0
}
}Illustrative values. Use the actual identifiers and credentials returned by your request.
Send a group message
Replace {group} with the actual IDs returned by the API.
curl --request POST "https://playjawib.com/api/v2/groups/{group}/messages" \
--header "Authorization: Bearer $JAWIB_API_KEY" \
--header 'Accept: application/json' \
--header 'Idempotency-Key: unique-operation-123' \
--header 'Content-Type: application/json' \
--data '{
"connection_id": "CONNECTION_UUID",
"type": "text",
"text": "Hello, everyone"
}'use Illuminate\Support\Facades\Http;
$response = Http::acceptJson()
->withToken(env('JAWIB_API_KEY'))
->withHeader('Idempotency-Key', 'unique-operation-123')
->send('POST', 'https://playjawib.com/api/v2/groups/{group}/messages', [
'json' => json_decode(<<<'JSON'
{
"connection_id": "CONNECTION_UUID",
"type": "text",
"text": "Hello, everyone"
}
JSON, true),
]);
$data = $response->throw()->json();// Run in your server, e.g. Node.js. Never expose the token in browser code.
const response = await fetch('https://playjawib.com/api/v2/groups/{group}/messages', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.JAWIB_API_KEY}`,
Accept: 'application/json',
'Idempotency-Key': 'unique-operation-123',
'Content-Type': 'application/json'
},
body: JSON.stringify({
"connection_id": "CONNECTION_UUID",
"type": "text",
"text": "Hello, everyone"
})
});
const data = await response.json();
if (!response.ok) throw new Error(data.message ?? 'Request failed');Request body fields
| Field | Type | Description |
|---|---|---|
typerequired | string | text / image / audio / video / document / reaction |
text | string | — |
caption | string | — |
media_url | string | — |
media | string | — |
filename | string | — |
voice_note | boolean | Only for audio. true sends PTT and requires a valid mono OGG/Opus stream. No transcoding. Incoming content resources/webhooks also expose voice_note. |
{
"data": {
"id": "019c0000-0000-7000-8000-000000000003",
"destination_type": "group",
"group_id": "123",
"receipt_scope": "observed_participants",
"type": "text",
"voice_note": false,
"status": "sent",
"failure_code": null,
"sent_at": "2026-10-29T09:00:00+00:00",
"delivered_at": null,
"read_at": null,
"failed_at": null,
"expires_at": "2026-11-28T09:00:00+00:00"
}
}Illustrative values. Use the actual identifiers and credentials returned by your request.
List group messages
Replace {group} with the actual IDs returned by the API.
curl --request GET "https://playjawib.com/api/v2/groups/{group}/messages" \
--header "Authorization: Bearer $JAWIB_API_KEY" \
--header 'Accept: application/json'use Illuminate\Support\Facades\Http;
$response = Http::acceptJson()
->withToken(env('JAWIB_API_KEY'))
->send('GET', 'https://playjawib.com/api/v2/groups/{group}/messages');
$data = $response->throw()->json();// Run in your server, e.g. Node.js. Never expose the token in browser code.
const response = await fetch('https://playjawib.com/api/v2/groups/{group}/messages', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.JAWIB_API_KEY}`,
Accept: 'application/json'
}
});
const data = await response.json();
if (!response.ok) throw new Error(data.message ?? 'Request failed');{
"data": [],
"next_after_id": null
}Illustrative values. Use the actual identifiers and credentials returned by your request.
List participant receipts
Replace {group}, {message} with the actual IDs returned by the API.
curl --request GET "https://playjawib.com/api/v2/groups/{group}/sent-messages/{message}/receipts" \
--header "Authorization: Bearer $JAWIB_API_KEY" \
--header 'Accept: application/json'use Illuminate\Support\Facades\Http;
$response = Http::acceptJson()
->withToken(env('JAWIB_API_KEY'))
->send('GET', 'https://playjawib.com/api/v2/groups/{group}/sent-messages/{message}/receipts');
$data = $response->throw()->json();// Run in your server, e.g. Node.js. Never expose the token in browser code.
const response = await fetch('https://playjawib.com/api/v2/groups/{group}/sent-messages/{message}/receipts', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.JAWIB_API_KEY}`,
Accept: 'application/json'
}
});
const data = await response.json();
if (!response.ok) throw new Error(data.message ?? 'Request failed');{
"data": [],
"meta": {
"message_id": "019c0000-0000-7000-8000-000000000003",
"scope": "observed_participants",
"complete": false,
"observed_participants": 0,
"delivery_confirmed": 0,
"read_confirmed": 0,
"played": 0
},
"next_after_id": null
}Illustrative values. Use the actual identifiers and credentials returned by your request.