WhatsApp Messages API - Session செய்திகளை அனுப்புதல்

மேலோட்டம்

WhatsApp Messages API கடந்த 24 மணி நேரத்தில் உங்களுக்கு எழுதிய ஒரு வாடிக்கையாளருக்கு free-form WhatsApp செய்திகளை (உரை, படங்கள், வீடியோக்கள், ஆடியோ மற்றும் ஆவணங்கள்) அனுப்புகிறது. இது Inbox-இலிருந்து பதிலளிப்பதன் API பதிப்பாகும், மேலும் செய்தி எந்த agent பதிலையும் போலவே உரையாடலில் சேமிக்கப்படுகிறது.

24 மணி நேர சாளரத்திற்கு வெளியே WhatsApp அங்கீகரிக்கப்பட்ட templates-ஐ மட்டுமே ஏற்கிறது. அவற்றுக்கு WhatsApp Templates API-ஐப் பயன்படுத்தவும்.

குறிப்பு: Send Messages API WhatsApp உட்பட ஒவ்வொரு சேனலுக்கும், ஒரே கோரிக்கை அமைப்பு மற்றும் உள்ளமைந்த பாதுகாப்பான மறுமுயற்சிகளுடன் இதே வேலையைச் செய்கிறது. நீங்கள் WhatsApp மற்றும் தொலைபேசி எண்களுடன் மட்டுமே வேலை செய்தால் இந்தப் பக்கத்தின் endpoint-ஐப் பயன்படுத்தவும்.

முன்தேவைகள்

• API அணுகல் உள்ள திட்டத்தில் (Pro அல்லது அதற்கு மேல்) ஒரு API key. ChatMaxima API-ஐப் பார்க்கவும்.
• Cloud API மூலம் இணைக்கப்பட்ட ஒரு WhatsApp கணக்கு. WhatsApp சேனல் அமைப்பு-ஐப் பார்க்கவும்.
• திறந்த உரையாடல். வாடிக்கையாளர் உங்களுக்கு அனுப்பிய கடைசிச் செய்தி 24 மணி நேரத்திற்குள் இருக்க வேண்டும்.

ஒரு session செய்தியை அனுப்புதல்

உரை

curl -X POST https://chatmaxima.com/api/v2/whatsapp/messages/send/ \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "a1b2c3d4e5f6",
    "mobile_no": "+15550001111",
    "reference_id": "ticket-2042",
    "message": "Thanks Jane, your refund has been approved."
  }'

படம், வீடியோ, ஆடியோ அல்லது ஆவணம்

message-ஐ ஒரு string-க்குப் பதிலாக object ஆக அனுப்பவும்:

{
  "account_id": "a1b2c3d4e5f6",
  "mobile_no": "+15550001111",
  "reference_id": "invoice-1001",
  "message": {
    "type": "document",
    "media_url": "https://cdn.example.com/invoice-1001.pdf",
    "file_name": "invoice-1001.pdf",
    "caption": "Your invoice"
  }
}

கோரிக்கைப் புலங்கள்

புலம்	வகை	தேவையா	விளக்கம்
mobile_no	string	ஆம்	நாட்டுக் குறியீட்டுடன் வாடிக்கையாளரின் எண்.
account_id	string	பல எண்கள் இருந்தால்	அனுப்ப வேண்டிய WhatsApp கணக்கு, Channel Accounts-இலிருந்து.
reference_id	string	இல்லை	உங்கள் சொந்த id. இந்தச் செய்திக்கு webhooks வேண்டுமென்றால் தேவை.
message	string அல்லது object	ஆம்	string உரையை அனுப்பும். object கொடுக்கப்பட்ட வகையை அனுப்பும்.
message.type	string	object வடிவத்தில்	text, image, video, audio அல்லது document.
message.text அல்லது message.caption	string	text-க்கு	உரை, அல்லது media-க்கான caption.
message.media_url	string	media-க்கு	கோப்பின் பொது https URL.
message.file_name	string	இல்லை	ஆவணங்களுக்குக் காட்டப்படும் கோப்புப் பெயர்.

பதில்

{
  "status": "success",
  "code": 201,
  "message": "Message sent",
  "data": {
    "message_id": "wamid.XXXXXXXX",
    "mobile_no": "15550001111",
    "account_id": "a1b2c3d4e5f6",
    "reference_id": "ticket-2042",
    "status": "sent",
    "created_datetime": "2026-11-03 10:05:00"
  }
}

குறிப்பு: Delivery, read மற்றும் failure webhooks ஒரு reference_id கொண்ட session செய்திகளுக்கு மட்டுமே அனுப்பப்படும். Template அனுப்புதல்கள் எப்போதும் அவற்றைத் தூண்டுகின்றன.

24 மணி நேர சாளரம்

அனுப்புவதற்கு முன் ChatMaxima சாளரத்தைச் சரிபார்க்கிறது. வாடிக்கையாளர் உங்களுக்கு ஒருபோதும் எழுதவில்லை என்றால், அல்லது அவர்களின் கடைசிச் செய்தி 24 மணி நேரத்திற்கு மேல் பழையதாக இருந்தால், கோரிக்கை 422 WINDOW_CLOSED உடன் தோல்வியடையும்:

{
  "error": {
    "code": "WINDOW_CLOSED",
    "message": "The 24-hour customer service window is closed (last inbound message was 31.4 hours ago). Send an approved template to reopen the conversation.",
    "details": { "window_open": false, "hours_since_last_inbound": 31.4 }
  }
}

அதற்குப் பதிலாக WhatsApp Templates API மூலம் அங்கீகரிக்கப்பட்ட template-ஐ அனுப்பவும். வாடிக்கையாளர் பதிலளிக்கும்போது, சாளரம் மீண்டும் 24 மணி நேரத்திற்குத் திறக்கும்.

ஒரு செய்தியின் நிலையைச் சரிபார்த்தல்

உங்கள் workspace-இல் உள்ள எந்த WhatsApp செய்தியையும் அதன் wamid மூலம் தேடலாம், அது API, bot அல்லது agent எதன் மூலம் அனுப்பப்பட்டிருந்தாலும் சரி. id-ஐ URL-encode செய்யவும்.

curl https://chatmaxima.com/api/v2/whatsapp/messages/wamid.XXXXXXXX/status/ \
  -H "Authorization: YOUR_API_KEY"

{
  "status": "success",
  "code": 200,
  "data": {
    "message_id": "wamid.XXXXXXXX",
    "status": "delivered",
    "error": null,
    "created_datetime": "2026-11-03 10:05:00",
    "updated_datetime": "2026-11-03 10:05:04"
  }
}

நிலை	பொருள்
sent	WhatsApp செய்தியை ஏற்றுக்கொண்டது.
delivered	அது வாடிக்கையாளரின் தொலைபேசியைச் சென்றடைந்தது.
read	வாடிக்கையாளர் அதைத் திறந்தார். இயக்கப்பட்ட voice notes-உம் read ஆகக் கணக்கிடப்படும்.
failed	WhatsApp-ஆல் அதை வழங்க முடியவில்லை. error Meta-வின் அறிக்கையைக் கொண்டுள்ளது.

நிலை முன்னோக்கி மட்டுமே நகரும். தாமதமாக வரும் delivered புதுப்பிப்பு ஒருபோதும் read-ஐ மேலெழுதாது. நேரங்கள் UTC-இல் உள்ளன.

பிழைகள்

HTTP	குறியீடு	எப்போது நிகழ்கிறது
422	MISSING_MOBILE_NO	mobile_no விடுபட்டுள்ளது.
422	INVALID_MOBILE_NO	சுத்தம் செய்த பிறகு எண் 7 முதல் 15 இலக்கங்களுக்குள் இல்லை.
422	UNSUPPORTED_MESSAGE_TYPE	message.type ஆதரிக்கப்படும் வகைகளில் ஒன்றல்ல.
422	MISSING_MESSAGE	உரை வெற்றாக உள்ளது.
422	MISSING_MEDIA_URL	media_url இல்லாமல் ஒரு media வகை அனுப்பப்பட்டது.
422	INVALID_MEDIA_URL	media_url ஒரு https URL அல்ல.
403	PLAN_EXPIRED	உங்கள் திட்டம் முடிந்துவிட்டது.
403	MESSAGE_LIMIT_REACHED	உங்கள் மாதாந்திர செய்தி ஒதுக்கீடு தீர்ந்துவிட்டது.
422	ACCOUNT_RESOLUTION_FAILED	account_id உங்கள் WhatsApp கணக்குகளில் ஒன்றல்ல, எதுவும் இணைக்கப்படவில்லை, அல்லது உங்களிடம் பல உள்ளன ஆனால் ஒன்றை அனுப்பவில்லை.
422	WINDOW_CLOSED	24 மணி நேர சாளரம் மூடப்பட்டுள்ளது அல்லது ஒருபோதும் திறக்கப்படவில்லை.
422	WHATSAPP_SEND_REJECTED	Meta செய்தியை நிராகரித்தது. details Meta-வின் பிழையைக் கொண்டுள்ளது.
502	SEND_UNCONFIRMED	ChatMaxima அனுப்புதலை உறுதிப்படுத்த முடியவில்லை. மீண்டும் முயற்சிக்கும் முன் நிலையைச் சரிபார்க்கவும்.
404	NOT_FOUND	நிலைத் தேடல்: உங்கள் workspace-இல் அந்த wamid கொண்ட செய்தி இல்லை.

அங்கீகாரம், திட்டம் மற்றும் rate-limit பிழைகள் API மேலோட்டம் பக்கத்தில் பட்டியலிடப்பட்டுள்ளன.

சிறந்த நடைமுறைகள்

• delivery கண்காணிப்புக்கு webhooks-ஐ நம்பியிருந்தால் எப்போதும் reference_id-ஐ அனுப்பவும்.
• வாடிக்கையாளர் கடைசியாக எப்போது எழுதினார் என்பது உங்களுக்குத் தெரிந்தால், தோல்வியடையும் அழைப்புகளைத் தவிர்க்க உங்கள் சொந்த logic-இல் முதலில் சாளரத்தைச் சரிபார்க்கவும்.
• அதிக அளவுகளுக்கு, status endpoint-ஐ polling செய்வதை விட webhooks-ஐ விரும்பவும்.

அடுத்த படிகள்

• WhatsApp Templates API →
• WhatsApp Webhooks →
• Send Messages API →