அம்சம்

உங்கள் சொந்த WhatsApp எண்ணில் ஒரு WhatsApp API

உங்கள் அணி பகிரப்பட்ட WhatsApp இன்பாக்ஸில் பதிலளிக்கும் அதே எண்ணில் Spun உங்களுக்கு ஒரு REST API-ஐ வழங்குகிறது: உரையும் மீடியாவும் அனுப்புங்கள், செய்திகளைப் படியுங்கள், தொடர்புகளையும் லேபிள்களையும் புதுப்பியுங்கள், வெப்ஹூக்குகளுக்கு சப்ஸ்கிரைப் செய்யுங்கள். QR ஸ்கேன் மூலம் நீங்கள் இணைத்த எண்ணின் முன் இது இயங்குகிறது, எனவே இதற்கு Business API தேவையில்லை, ஒவ்வொரு செய்திக்கும் கட்டணமும் இல்லை.

ஒரு WhatsApp API செய்ய வேண்டிய வேலைகளில் பெரும்பாலானவை நான்கு விஷயங்களுக்குள் அடங்கும்: ஒரு செய்தியை அனுப்புவது, ஒன்றைத் தேடிப் பார்ப்பது, ஒரு பதிவை மாற்றுவது, ஏதாவது நடந்தால் அதைப் பற்றித் தெரிந்துகொள்வது. உங்கள் அணி இன்பாக்ஸில் பதிலளிக்கும் அதே எண்ணுக்கு, சாதாரண HTTP வழியாக Spun இந்த நான்கையும் வழங்குகிறது; நீங்களே உருவாக்கி, ஒருங்கிணைப்புக்குத் தேவையானதற்கு மட்டும் ஸ்கோப் வரம்பிடும் ஒரு கீ மூலம் அங்கீகாரம் நடக்கிறது.

இந்தப் பக்கம் இதன் நடைமுறை வடிவம்: எண்ட்பாயிண்ட்கள் எவை, அங்கீகாரமும் ஸ்கோப்களும் எப்படி வேலை செய்கின்றன, நீங்கள் கோரிக்கை அனுப்பும் அதே நேரத்தில் உங்கள் WhatsApp லைன் ஆஃப்லைனில் இருந்தால் என்ன நடக்கும், இயந்திரம் படிக்கக்கூடிய API ஒப்பந்தம் எங்கே இருக்கிறது.

கீக்கள், ஸ்கோப்கள், கசிந்தால் ஏற்படும் பாதிப்பின் அளவு

அங்கீகாரம் ஒரு பேரர் டோக்கன் மூலம் நடக்கிறது. நீங்கள் ஆப்பில் ஒரு கீயை உருவாக்குகிறீர்கள், அது உங்களுக்கு ஒரு முறை மட்டுமே காட்டப்படும், ஒவ்வொரு கோரிக்கையும் அதை Authorization ஹெடரில் கொண்டு செல்கிறது. Spun கீயின் ஹாஷை மட்டுமே சேமிக்கிறது, எனவே தொலைந்த கீயை மீட்க முடியாது, மாற்ற மட்டுமே முடியும்.

ஒரு நிமிடம் செலவிடத் தகுந்த பகுதி ஸ்கோப் அமைப்பு. ஒரு கீ என்பது வெறும் "கணக்குக்கான அணுகல்" அல்ல: அதனுடன் ஸ்கோப்களின் பட்டியல் இருக்கும், ஒவ்வொரு எண்ட்பாயிண்ட்டும் தனக்குத் தேவையான குறிப்பிட்ட ஸ்கோப் உள்ளதா என்று சரிபார்க்கும். read_contacts மட்டும் உள்ள கீயால் செய்தி அனுப்ப முடியாது. send_message மட்டும் உள்ள கீயால் உங்கள் தொடர்புப் பட்டியலை ஒவ்வொன்றாக எடுக்க முடியாது. ஸ்கோப்களுக்கு மேல், ஒரு கீக்குக் காலாவதி தேதியும் IP அனுமதிப் பட்டியலும் அமைக்கலாம், எனவே நிலையான முகவரி கொண்ட ஒரு சர்வருக்கு வழங்கப்பட்ட கீ, வேறு எங்கிருந்தாவது பயன்படுத்தப்படும் அந்தக் கணமே வேலை செய்வதை நிறுத்திவிடும்.

  • send_message உரை மற்றும் மீடியா அனுப்புதலையும், வரிசையில் வைக்கப்பட்ட அனுப்புதலைத் திரும்பப் படிப்பதையும் உள்ளடக்கும்.
  • read_contacts, read_messages, read_labels ஆகியவை படிக்கும் பக்கம், ஒவ்வொன்றையும் தனித்தனியாக வழங்கலாம்.
  • manage_contacts, manage_labels ஆகியவை உருவாக்குதல், புதுப்பித்தல், லேபிள் இடுதல் ஆகியவற்றை உள்ளடக்கும்.
  • check_phone ஒரு எண்ணை WhatsApp-இல் அணுக முடியுமா என்று பதில் சொல்லும்.
  • manage_webhooks வெப்ஹூக் சப்ஸ்கிரிப்ஷன்களை உருவாக்குகிறது, பட்டியலிடுகிறது, நீக்குகிறது.

கோரிக்கை

curl -X POST https://api.spun.com/api/integrations/send-message \
  -H "Authorization: Bearer wap_0f3c9a1d7b524e86a1c05d9e2f7b48ac" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155550142",
    "text": "Your appointment is confirmed for Thursday at 10:00.",
    "idempotency_key": "booking-8871"
  }'

பதில்

HTTP/1.1 200 OK
Content-Type: application/json

{
  "success": true,
  "message_id": "yq0Zt9C1sK2mfE7x"
}
ஒரு செய்தியை அனுப்புதல். ஐடெம்போடென்சி கீ விருப்பத்தேர்வு; அதே கீயுடன் அதே கோரிக்கையை மீண்டும் அனுப்பினால், இரண்டாவது முறை அனுப்பப்படுவதற்குப் பதிலாக அசல் செய்தியின் id உங்களுக்குத் திரும்பக் கிடைக்கும்.

Spun MCP சர்வருக்காக உருவாக்கப்பட்ட கீக்கள், செல்லுபடியான கீக்களாக இருந்தாலும், இந்த API-இல் வேண்டுமென்றே நிராகரிக்கப்படுகின்றன. இரண்டு இடைமுகங்களுக்கும் ஒப்புதல் விதிகள் வேறுபட்டவை, ஒன்றுக்காக வழங்கப்பட்ட கீயை மற்றொன்றில் அமைதியாகப் பயன்படுத்த முடியாது.

தொடர்புடையது: கோட் எழுதுவதற்குப் பதிலாக ஒரு AI உதவியாளரை இணைத்தல்

WhatsApp API எண்ட்பாயிண்ட்கள் உண்மையில் எவற்றை உள்ளடக்குகின்றன

இந்த இடைமுகம் தயாரிப்பின் முழுமையான நகலாக இல்லாமல், வேண்டுமென்றே சிறியதாகவும் நிலையானதாகவும் வைக்கப்பட்டுள்ளது. வெளிப்புற சிஸ்டம்கள் உண்மையில் செய்ய வேண்டிய வேலைகளை ஒரு வெளிப்புற சிஸ்டம் செய்ய முடிய வேண்டும் என்பதற்காகவே இது இருக்கிறது.

  • அனுப்புதல்: ஒரு உரைச் செய்தி, அல்லது URL அல்லது base64 வடிவில் மீடியா, விருப்பமான கேப்ஷனுடன்.
  • தொடர்புகள்: ஒரு தொடர்பை உருவாக்குங்கள், ஒன்றைப் புதுப்பியுங்கள், கர்சர் பேஜினேஷனுடன் தொடர்புகளைப் பட்டியலிடுங்கள்.
  • லேபிள்கள்: பணியிடத்தில் உள்ள லேபிள்களைப் பட்டியலிடுங்கள், ஒரு உரையாடலுக்கு லேபிள் இடுங்கள், லேபிளை நீக்குங்கள்.
  • செய்திகள்: தரவுக் கிடங்கு அல்லது CRM-இல் ஒத்திசைப்பதற்காக, கர்சர் பேஜினேஷனுடன் செய்திகளைப் பட்டியலிடுங்கள்.
  • தொலைபேசி சரிபார்ப்பு: ஒரு எண்ணை வைத்துப் பட்டியல் உருவாக்கும் முன் அது WhatsApp-இல் உள்ளதா என்று உறுதிசெய்யுங்கள்.
  • காத்திருப்பு வரிசை: லைன் ஆஃப்லைனில் இருந்ததால் வரிசையில் வைக்கப்பட்ட ஒரு அனுப்புதலைத் தேடிப் பாருங்கள்.
  • வெப்ஹூக்குகள்: சப்ஸ்கிரிப்ஷன்களை உருவாக்குங்கள், பட்டியலிடுங்கள், நீக்குங்கள்.

இயந்திரம் படிக்கக்கூடிய ஒப்பந்தம் /api/integrations/openapi.json என்ற முகவரியில் வெளியிடப்பட்டுள்ளது, அதைப் படிக்க எந்தக் கீயும் தேவையில்லை, எனவே n8n நோட் எழுதுபவர், Zapier ஆப் உருவாக்குபவர் அல்லது உங்கள் சொந்த ஜெனரேட்டர், யாருக்கும் அணுகல் சான்றுகள் வழங்கப்படுவதற்கு முன்பே ஸ்பெக்கைப் பெறலாம்.

WhatsApp லைன் ஆஃப்லைனில் இருக்கும்போது என்ன நடக்கும்

பலரை ஆச்சரியப்படுத்தும் பகுதி இதுதான், எனவே இதைத் தெளிவாகச் சொல்வது நல்லது. Spun ஒரு நேரடி WhatsApp செஷன் மூலம் அனுப்புகிறது, உங்கள் கோட் கோரிக்கை அனுப்பும் அதே விநாடியில் அந்த நேரடி செஷன் செயலிழந்திருக்கலாம். API இதை மறைப்பதில்லை, அது உரைக்கும் மீடியாவுக்கும் வேண்டுமென்றே வெவ்வேறு விதமாகச் செயல்படுகிறது.

ஆஃப்லைன் லைனுக்கு அனுப்பப்படும் உரைச் செய்திக்கு, பிழைக்குப் பதிலாக 202 திரும்பும், அதனுடன் ஒரு வரிசை id. செய்தி நிறுத்தி வைக்கப்பட்டு, லைன் மீண்டும் இணைந்ததும் டெலிவர் செய்யப்படும், அதன் நிலையை அறிய காத்திருப்பு வரிசை எண்ட்பாயிண்ட்டை நீங்கள் அவ்வப்போது சரிபார்க்கலாம். ஆஃப்லைன் லைனுக்கு அனுப்பப்படும் மீடியாவுக்கு அதற்குப் பதிலாக முரண்பாட்டுப் பிழை திரும்பும், எதுவும் அனுப்பப்படாது. இந்த வேறுபாடு வேண்டுமென்றே செய்யப்பட்டது: காத்திருப்பு வரிசை செய்திகளை உரையாக அனுப்புகிறது, எனவே வரிசையில் வைக்கப்பட்ட படம், படமே இல்லாமல் வெறும் கேப்ஷனாக வந்து சேரும். வெளிப்படையாகத் தோல்வியடைவதே சிறந்த முடிவு, அடுத்து என்ன செய்வது என்பதை உங்கள் மறுமுயற்சி லாஜிக் தீர்மானிக்கும்.

கோரிக்கை வேக வரம்பு ஒவ்வொரு கீக்கும் நிமிடத்துக்கு 60 கோரிக்கைகள், ஒவ்வொரு பதிலிலும் நிலையான வேக வரம்பு ஹெடர்கள் இருக்கும், எனவே எதிர்பாராத 429 பிழைக்காகக் காத்திருக்காமல், ஹெடர்களைப் பார்த்தே ஒரு கிளையன்ட் வேகத்தைக் குறைக்கலாம்.

வெப்ஹூக்குகள்: அடிக்கடி சரிபார்க்காமலே தகவல் பெறுங்கள்

ஒரு டைமரில் செய்திகள் எண்ட்பாயிண்ட்டை அடிக்கடி சரிபார்ப்பது உரையாடலுக்குப் பொருந்தாத வழி, எனவே API தானே தகவலை அனுப்ப முடியும். நீங்கள் ஒரு URL-ஐயும் உங்களுக்குத் தேவையான நிகழ்வுகளையும் பதிவு செய்கிறீர்கள், அவை நடக்கும்போதே Spun அந்த URL-க்கு ஒரு JSON உள்ளடக்கத்தை அனுப்புகிறது.

ஒவ்வொரு டெலிவரியின் ஹெடர்களிலும் நிகழ்வின் பெயரும் ஒரு தனித்துவமான டெலிவரி id-உம் இருக்கும், சப்ஸ்கிரிப்ஷனுக்குக் கையொப்ப ரகசியம் இருந்தால், அதே உள்ளடக்கத்தின் HMAC-SHA256 கையொப்பமும் இருக்கும். பேலோடை நம்புவதற்கு முன் கையொப்பத்தைச் சரிபார்க்குங்கள்: URL தெரிந்துகொள்ளும் எவரிடமிருந்தும் உங்கள் எண்ட்பாயிண்ட்டைப் பிரித்துக் காப்பது அது ஒன்றுதான். சப்ஸ்கிரிப்ஷனை உருவாக்கும்போது ரகசியம் ஒரு முறை மட்டுமே திருப்பி அனுப்பப்படும், பிறகு ஒருபோதும் இல்லை.

  • செய்தி நிகழ்வுகள், உள்வரும் மற்றும் வெளிச்செல்லும்.
  • தொடர்பு உருவாக்கப்பட்டது, புதுப்பிக்கப்பட்டது, நீக்கப்பட்டது.
  • லேபிள் ஒதுக்கப்பட்டது.
  • சாட் ஃப்ளோ நிறைவடைந்தது, வரிசையில் வைக்கப்பட்ட அனுப்புதல் செயலாக்கப்பட்டது, லீட் தகுதி பெற்றது.
  • உரையாடல் முடிக்கப்பட்டது, அழைப்பு நிறைவடைந்தது, பைப்லைன் நிலை மாறியது.

தொடர்புடையது: Zapier மற்றும் Make-உடன் Spun-ஐ இணைத்தல் · n8n-உடன் Spun-ஐ இணைத்தல் · ஒரு ஹெல்ப்டெஸ்க்கை இணைத்தல்: Zendesk, Zoho Desk, Freshdesk, HubSpot Service Hub, Jira

வரம்புகளும் நேர்மையான எச்சரிக்கைகளும்

  • இது WhatsApp Business API அல்ல. இது நீங்கள் இணைத்த எண்ணின் முன் இயங்கும் Spun-இன் சொந்த API, எனவே ஒப்புதல் பெற வேண்டிய செய்தி டெம்ப்ளேட்கள் இல்லை, ஒவ்வொரு செய்திக்கும் கட்டணம் இல்லை, அதேபோல் Meta-இன் அதிகாரப்பூர்வ உத்தரவாதங்களும் இல்லை.
  • ஒவ்வொரு கீக்கும் நிமிடத்துக்கு அறுபது கோரிக்கைகள். மொத்தமாகச் செய்யும் வேலை, தங்கள் வேகத்தைத் தாங்களே சரியாகக் கட்டுப்படுத்தும் பிரச்சாரங்களில் நடக்க வேண்டும், வேகமான API லூப்பில் அல்ல.
  • மேலே உள்ள எண்ட்பாயிண்ட் பட்டியல்தான் இன்றைய முழு இடைமுகம். அதில் இல்லாத எதுவும் வழங்கப்படவில்லை, ஆவணப்படுத்தப்படாத எந்த எண்ட்பாயிண்ட்டையும் நம்பக் கூடாது.
  • ஒரு கீக்கு ஸ்கோப் உண்டு, ஆனால் அது ஒவ்வொரு பயனருக்கும் தனியானது அல்ல. அதைப் பணியிடத்தின் அணுகல் சான்றுகளாகக் கருதுங்கள், அணுகல் உள்ள ஒருவர் விலகும்போது அதை மாற்றுங்கள்.
  • ஒருபோதும் சம்மதம் தராதவர்களுக்குச் செய்தி அனுப்பினால், செய்தி எந்த வழியில் சென்றிருந்தாலும் WhatsApp அந்த எண்ணைக் கட்டுப்படுத்தும்.

தொடர்புடையது: Spun WhatsApp-உடன் எப்படி இணைகிறது

அடிக்கடி கேட்கப்படும் கேள்விகள்

இதைப் பயன்படுத்த WhatsApp Business API தேவையா?

இல்லை. இது QR ஸ்கேன் மூலம் இணைக்கப்பட்ட உங்கள் சொந்த WhatsApp எண்ணின் முன் இயங்கும் Spun-இன் சொந்த REST API. Meta விண்ணப்பம் இல்லை, டெம்ப்ளேட் ஒப்புதலுக்கான காத்திருப்பு வரிசை இல்லை, ஒவ்வொரு செய்திக்கும் கட்டணமும் இல்லை.

API கீயை எப்படிப் பெறுவது?

கணக்கின் மேலாளர் ஒருவர் ஆப்பில் ஒரு கீயை உருவாக்கி, அதன் ஸ்கோப்களைத் தேர்ந்தெடுத்து, விரும்பினால் காலாவதி தேதியையும் IP அனுமதிப் பட்டியலையும் அமைக்கிறார். உருவாக்கும்போது அசல் கீ ஒரு முறை மட்டுமே காட்டப்படும்; அதன் பிறகு Spun அதன் ஹாஷை மட்டுமே சேமிக்கிறது.

OpenAPI ஸ்பெக் உள்ளதா?

ஆம், /api/integrations/openapi.json என்ற முகவரியில் வெளியிடப்பட்டுள்ளது, அணுகல் சான்றுகள் உருவாவதற்கு முன்பே கருவிகள் ஒரு கிளையன்டை உருவாக்க முடியும் என்பதற்காக, கீ இல்லாமலேயே அதைப் படிக்கலாம்.

ஒரே கோரிக்கையை இரண்டு முறை அனுப்பினால் என்ன நடக்கும்?

ஒரு ஐடெம்போடென்சி கீயை அனுப்புங்கள். அதே கீயுடன் மீண்டும் அனுப்பப்படும் கோரிக்கை, இரண்டாவது செய்தியை அனுப்புவதற்குப் பதிலாக அசல் செய்தி id-ஐத் திருப்பித் தந்து, பதிலை ஐடெம்போடென்ட் எனக் குறிக்கும். கீ இல்லாவிட்டால், இரண்டு கோரிக்கைகள் என்றால் இரண்டு செய்திகள்.

ஒரு வெப்ஹூக் உண்மையில் Spun-இலிருந்துதான் வந்தது என்று எப்படிச் சரிபார்ப்பது?

சப்ஸ்கிரிப்ஷனுக்கு ஒரு கையொப்ப ரகசியத்தைக் கொடுத்து, கையொப்ப ஹெடரைச் சரிபார்க்குங்கள்; அது மூல கோரிக்கை உள்ளடக்கத்தின் HMAC-SHA256, sha256 என்பதைத் தொடர்ந்து ஹெக்ஸ் டைஜஸ்ட் என்ற வடிவில் இருக்கும். பார்ஸ் செய்வதற்கு முன், நீங்கள் பெற்ற அதே பைட்டுகளின் மீது நீங்களே கணக்கிட்டதுடன் அதை ஒப்பிடுங்கள்.

உங்கள் வாடிக்கையாளர்கள் ஏற்கனவே செய்தி அனுப்பும் எண்ணின் மீதே உருவாக்குங்கள்

ஸ்கோப் கொண்ட கீக்கள், சிறிய மற்றும் நிலையான இடைமுகம், உங்களை அடிக்கடி சரிபார்க்க வைப்பதற்குப் பதிலாகத் தாமே தகவலை அனுப்பும் வெப்ஹூக்குகள், ஒவ்வொரு செய்திக்குமான கட்டண மீட்டர் இல்லை.

இலவசமாகத் தொடங்குங்கள்: 7 நாட்களுக்கு எல்லாமே

Spun-இன் அனைத்து அம்சங்களையும் பாருங்கள்

இதில் மேலும்: உங்கள் கருவிகளுடன் இணைந்து செயல்படும்

மேலும் அம்சங்கள், விரிவாக

வீடியோ அழைப்புகள் · மொழிபெயர்ப்பு அறை · திட்டமிடப்பட்ட செய்திகள் · AI தானியங்கி பதில்கள் · இணைப்புப் பகுதி & Self Proxy · உரையாடலிலிருந்தே மின்னஞ்சல் · ஒருவருக்கு ஒரே உரையாடல் · சாட்களைத் தானாக ஒதுக்குதல் · விற்பனை பைப்லைன் · சுழற்றி வெல்லும் Lead Games · WhatsApp மார்க்கெட்டிங் · குழு நுண்ணறிவு · தொடர்பு வட்டங்கள் · குரல் சாட்பாட் · அறிக்கைகள், சுருக்கத் தொகுப்புகள் · Weave · அணி செயல்திறன்