API Reference v4.0

API Documentation

Complete reference for the dChats Messenger messaging API. Examples in cURL, JavaScript, Python, and PHP.

Base URL: graph-api.v4-0.dchats.org

REST over HTTPS · No OAuth required for testing

Messaging API

GETSend Text Message GETSend Template Button Message

Auth API

GETSMS Verification

GEThttps://graph-api.v4-0.dchats.org/outsource/v4/

Send Text Message

Send a plain text dChats message to any recipient.

Query Parameters

Parameter	Type	Required	Description
`sender_uuid`	`string`	required	Your dChats Messenger sender UUID from Settings
`to`	`string`	required	Recipient phone number with country code (no + sign). E.g. 919876543210
`type`	`"text"`	required	Must be "text" for plain messages
`body`	`string`	required	The message text to send
`content`	`string`	optional	Same as body (legacy compatibility)
`send_msg`	`"true"`	required	Must be "true" to actually deliver the message

Code Examples

curl "https://graph-api.v4-0.dchats.org/outsource/v4/?sender_uuid=ntc1mjc-xxx&to=919876543210&type=text&body=Hello+World&send_msg=true"

Responses

200Message sent successfully

{"success":true,"message_id":"msg_xxx","status":"sent"}

400Missing or invalid parameters

{"success":false,"error":"sender_uuid is required"}

401Unauthorized / invalid token

{"success":false,"error":"Invalid auth token"}

GEThttps://graph-api.v4-0.dchats.org/outsource/v4/

Send Template Button Message

Send an interactive message with header, body, optional media image, URL buttons, and quick reply buttons.

Query Parameters

Parameter	Type	Required	Description
`sender_uuid`	`string`	required	Your dChats Messenger sender UUID
`to`	`string`	required	Recipient phone number (country code, no +)
`type`	`"template_button"`	required	Must be "template_button"
`header`	`string`	optional	Bold header text shown above body
`body`	`string`	required	Main message body text
`media_url`	`string (URL)`	optional	URL of image to display above header
`url_buttons[]`	`string`	optional	Format: "Label\|URL". Repeat for multiple buttons.
`buttons[]`	`string`	optional	Quick reply button label. Repeat for multiple.
`send_msg`	`"true"`	required	Must be "true"

Code Examples

curl "https://graph-api.v4-0.dchats.org/outsource/v4/?send_msg=true&sender_uuid=xxx&to=919876543210&type=template_button&header=Limited+Time%21&body=Get+20%25+off+this+weekend%21&url_buttons[]=Shop+Now|https://shop.com&buttons[]=Remind+Me+Later"

Responses

200Template message sent

{"success":true,"type":"template_button","status":"sent"}

400Invalid params

{"success":false,"error":"body is required"}

SMS Verification API

Used internally by the login page for phone-based QR verification. Base URL: https://accounts.devsecit.com/sms/

GEThttps://accounts.devsecit.com/sms/?GET_TOKEN=true

Generate a new SMS verification token. Returns code, receiver phone, and validity timestamp.

{"code":"base64token==","ip":"x.x.x.x","validity":1775413299,"receiver":"+919876543210"}

GEThttps://accounts.devsecit.com/sms/?CHECK_STATUS={token}

Check if the token has been verified via SMS. Returns "Pending" or "Verified".

{"status":"Verified","message":"SMS verified successfully!"}

Pro Tip: Use the Portal Proxy

Instead of calling the dChats Messenger API directly, you can use the built-in portal proxy at /api/send-message. This keeps your Auth Bearer Token server-side and accepts JSON POST requests.

POST /api/send-message
Content-Type: application/json

{
  "sender_uuid": "your-uuid",
  "to": "919876543210",
  "type": "text",
  "body": "Hello from the portal proxy!"
}