Authentication
All requests require a Token and Instance ID.
| token | Personal API key (JWT) |
| instance_id | Connected WhatsApp instance identifier |
| jid | Target number in WhatsApp format |
JID Format
972501234567@s.whatsapp.net
Base URL
https://ibot-chat.com/api/v1
איך לקבל את הפרטים?
התחבר לדשבורד וחבר את WhatsApp. לאחר החיבור תראה:
| Instance ID | מזהה ה-Instance שלך - זהו גם ה-Token לשימוש ב-API |
| Client ID | מזהה הלקוח (השם שנתת לחיבור) |
Dashboard → מחובר בהצלחה → Instance ID (Token)
Send Text Message
GET
/send-text
Example Request
https://ibot-chat.com/api/v1/send-text?token=TOKEN&instance_id=INSTANCE_ID&jid=972501234567@s.whatsapp.net&msg=Hello%20World
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| token | string | ✅ | API token |
| instance_id | string | ✅ | WhatsApp instance ID |
| jid | string | ✅ | WhatsApp JID |
| msg | string | ✅ | Text message |
✓ Success Response
{
"success": true,
"message": "Message sent successfully!",
"response": "<RESPONSE>"
}
✗ Error Response
{
"success": false,
"message": "<REASON>"
}
Send Image
GET
/send-image
Example Request
https://ibot-chat.com/api/v1/send-image?token=TOKEN&instance_id=INSTANCE_ID&jid=972501234567@s.whatsapp.net&caption=My%20Image&imageurl=https://example.com/image.jpg
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| token | string | ✅ | API token |
| instance_id | string | ✅ | WhatsApp instance ID |
| jid | string | ✅ | WhatsApp JID |
| imageurl | string | ✅ | Public image URL |
| caption | string | ✅ | Image caption (can be empty string) |
Send Video
GET
/send-video
Example Request
https://ibot-chat.com/api/v1/send-video?token=TOKEN&instance_id=INSTANCE_ID&jid=972501234567@s.whatsapp.net&caption=Watch%20this&videourl=https://example.com/video.mp4
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| token | string | ✅ | API token |
| instance_id | string | ✅ | WhatsApp instance ID |
| jid | string | ✅ | WhatsApp JID |
| videourl | string | ✅ | Public video URL |
| caption | string | ✅ | Video caption (can be empty string) |
Send Audio
GET
/send-audio
Example Request
https://ibot-chat.com/api/v1/send-audio?token=TOKEN&instance_id=INSTANCE_ID&jid=972501234567@s.whatsapp.net&audiourl=https://example.com/audio.mp3
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| token | string | ✅ | API token |
| instance_id | string | ✅ | WhatsApp instance ID |
| jid | string | ✅ | WhatsApp JID |
| audiourl | string | ✅ | Public audio URL |
Send Document
Send PDF, DOCX, and other document files.
GET
/send-doc
Example Request
https://ibot-chat.com/api/v1/send-doc?token=TOKEN&instance_id=INSTANCE_ID&jid=972501234567@s.whatsapp.net&caption=Invoice&docurl=https://example.com/file.pdf
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| token | string | ✅ | API token |
| instance_id | string | ✅ | WhatsApp instance ID |
| jid | string | ✅ | WhatsApp JID |
| docurl | string | ✅ | Public document URL |
| caption | string | ✅ | Document caption (can be empty string) |
Notes & Best Practices
Important
- All URLs must be public (HTTPS)
- Use URL Encoding for text parameters (
msg,caption) - Avoid sending high volumes of parallel requests
- Token is personal – never expose in client-side code
Common Errors
| Error | Reason |
|---|---|
| Invalid token | Token is invalid or expired |
| Instance not connected | WhatsApp is not connected |
| Invalid JID | Phone number format is incorrect |
| Media not accessible | File is not publicly accessible |