നിങ്ങളുടെ ടീം പങ്കിട്ട WhatsApp ഇൻബോക്സിൽ മറുപടി നൽകുന്ന അതേ നമ്പറിൽ Spun നിങ്ങൾക്ക് ഒരു REST API നൽകുന്നു: ടെക്സ്റ്റും മീഡിയയും അയയ്ക്കുക, മെസേജുകൾ വായിക്കുക, കോൺടാക്ടുകളും ലേബലുകളും അപ്ഡേറ്റ് ചെയ്യുക, വെബ്ഹുക്കുകൾ സബ്സ്ക്രൈബ് ചെയ്യുക. QR സ്കാൻ വഴി നിങ്ങൾ ലിങ്ക് ചെയ്ത നമ്പറിന് മുന്നിലാണ് ഇത് പ്രവർത്തിക്കുന്നത്, അതിനാൽ ഇതിന് Business API ആവശ്യമില്ല, ഓരോ മെസേജിനുമുള്ള ഫീസും ഇല്ല.
ഒരു WhatsApp API-യോട് ആവശ്യപ്പെടുന്ന ജോലികളിൽ മിക്കതും നാല് കാര്യങ്ങളിൽ ഒതുങ്ങുന്നു: ഒരു മെസേജ് അയയ്ക്കുക, എന്തെങ്കിലും തിരയുക, ഒരു റെക്കോർഡ് മാറ്റുക, എന്തെങ്കിലും സംഭവിക്കുമ്പോൾ അറിയിപ്പ് നേടുക. നിങ്ങളുടെ ടീം ഇൻബോക്സിൽ മറുപടി നൽകുന്ന അതേ നമ്പറിനായി Spun ഈ നാലും സാധാരണ HTTP വഴി നൽകുന്നു. ഓതന്റിക്കേഷൻ നടക്കുന്നത് നിങ്ങൾ തന്നെ സൃഷ്ടിക്കുന്ന ഒരു കീ ഉപയോഗിച്ചാണ്, ഇന്റഗ്രേഷന് ആവശ്യമുള്ള സ്കോപ്പുകളിലേക്ക് മാത്രം നിങ്ങൾ അതിനെ പരിമിതപ്പെടുത്തുന്നു.
ഈ പേജ് അതിന്റെ പ്രായോഗിക രൂപമാണ്: എൻഡ്പോയിന്റുകൾ ഏതൊക്കെയാണ്, ഓതന്റിക്കേഷനും സ്കോപ്പുകളും എങ്ങനെ പ്രവർത്തിക്കുന്നു, നിങ്ങൾ കോൾ ചെയ്യുന്ന നിമിഷം നിങ്ങളുടെ WhatsApp ലൈൻ ഓഫ്ലൈൻ ആണെങ്കിൽ എന്ത് സംഭവിക്കും, മെഷീന് വായിക്കാവുന്ന കോൺട്രാക്ട് എവിടെ ലഭിക്കും.
കീകൾ, സ്കോപ്പുകൾ, ചോർന്നാൽ ഉണ്ടാകുന്ന നഷ്ടത്തിന്റെ വ്യാപ്തി
ഓതന്റിക്കേഷൻ ഒരു ബെയറർ ടോക്കൺ ഉപയോഗിച്ചാണ്. നിങ്ങൾ ആപ്പിൽ ഒരു കീ സൃഷ്ടിക്കുന്നു, അത് ഒരിക്കൽ മാത്രമേ നിങ്ങളെ കാണിക്കൂ, ഓരോ റിക്വസ്റ്റും അത് ഒരു Authorization ഹെഡറിൽ കൊണ്ടുപോകുന്നു. Spun കീയുടെ ഒരു ഹാഷ് മാത്രമാണ് സൂക്ഷിക്കുന്നത്, അതിനാൽ നഷ്ടപ്പെട്ട ഒരു കീ വീണ്ടെടുക്കാനാവില്ല, മാറ്റിസ്ഥാപിക്കാൻ മാത്രമേ കഴിയൂ.
ഒരു മിനിറ്റ് ചെലവഴിക്കേണ്ട ഭാഗം സ്കോപ്പിംഗ് ആണ്. ഒരു കീ എന്നത് വെറും "അക്കൗണ്ടിലേക്കുള്ള ആക്സസ്" അല്ല: അതിനൊപ്പം സ്കോപ്പുകളുടെ ഒരു ലിസ്റ്റ് ഉണ്ട്, ഓരോ എൻഡ്പോയിന്റും തനിക്ക് ആവശ്യമുള്ള പ്രത്യേക സ്കോപ്പ് പരിശോധിക്കുന്നു. read_contacts മാത്രമുള്ള ഒരു കീയ്ക്ക് മെസേജ് അയയ്ക്കാനാവില്ല. send_message മാത്രമുള്ള ഒരു കീയ്ക്ക് നിങ്ങളുടെ കോൺടാക്ട് ലിസ്റ്റ് ഒന്നൊന്നായി എടുക്കാനാവില്ല. സ്കോപ്പുകൾക്ക് പുറമേ, ഒരു കീയ്ക്ക് കാലാവധി തീയതിയും IP അലൗലിസ്റ്റും നൽകാം, അങ്ങനെ സ്ഥിരമായ വിലാസമുള്ള ഒരു സെർവറിന് നൽകിയ കീ മറ്റെവിടെ നിന്നെങ്കിലും ഉപയോഗിക്കുന്ന നിമിഷം പ്രവർത്തനം നിർത്തുന്നു.
- send_message ടെക്സ്റ്റും മീഡിയയും അയയ്ക്കുന്നതും ക്യൂവിൽ വെച്ച ഒരു സെൻഡ് തിരികെ വായിക്കുന്നതും ഉൾക്കൊള്ളുന്നു.
- read_contacts, read_messages, read_labels എന്നിവ വായിക്കുന്ന ഭാഗമാണ്, ഇവ പ്രത്യേകം പ്രത്യേകം നൽകാം.
- manage_contacts, manage_labels എന്നിവ സൃഷ്ടിക്കൽ, അപ്ഡേറ്റ് ചെയ്യൽ, ലേബൽ ചെയ്യൽ എന്നിവ ഉൾക്കൊള്ളുന്നു.
- ഒരു നമ്പറിൽ WhatsApp വഴി എത്താനാകുമോ എന്ന് check_phone പറയുന്നു.
- 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"
}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 അറിയുന്ന ആരിൽ നിന്നും നിങ്ങളുടെ എൻഡ്പോയിന്റിനെ വേർതിരിക്കുന്ന ഒരേയൊരു കാര്യം അതാണ്. സബ്സ്ക്രിപ്ഷൻ സൃഷ്ടിക്കുമ്പോൾ ഒരിക്കൽ മാത്രമാണ് സീക്രട്ട് തിരികെ നൽകുന്നത്, പിന്നീട് ഒരിക്കലും ഇല്ല.
- മെസേജ് ഇവന്റുകൾ, വരുന്നതും പോകുന്നതും.
- കോൺടാക്ട് സൃഷ്ടിച്ചു, അപ്ഡേറ്റ് ചെയ്തു, ഇല്ലാതാക്കി.
- ലേബൽ അസൈൻ ചെയ്തു.
- ചാറ്റ് ഫ്ലോ പൂർത്തിയായി, ക്യൂവിലെ സെൻഡ് പ്രോസസ് ചെയ്തു, ലീഡ് യോഗ്യത നേടി.
- സംഭാഷണം അവസാനിപ്പിച്ചു, കോൾ പൂർത്തിയായി, പൈപ്പ്ലൈൻ ഘട്ടം മാറി.
ബന്ധപ്പെട്ടത്: Spun-നെ Zapier, Make എന്നിവയുമായി കണക്ട് ചെയ്യുക · Spun-നെ n8n-മായി കണക്ട് ചെയ്യുക · ഒരു ഹെൽപ്പ്ഡെസ്ക് കണക്ട് ചെയ്യുക: Zendesk, Zoho Desk, Freshdesk, HubSpot Service Hub, Jira
പരിധികളും സത്യസന്ധമായ മുന്നറിയിപ്പുകളും
- ഇത് WhatsApp Business API അല്ല. നിങ്ങൾ ലിങ്ക് ചെയ്ത നമ്പറിന് മുന്നിലുള്ള Spun-ന്റെ സ്വന്തം API ആണ് ഇത്, അതിനാൽ അംഗീകാരം നേടേണ്ട മെസേജ് ടെംപ്ലേറ്റുകളോ ഓരോ മെസേജിനുമുള്ള ഫീസോ ഇല്ല, അതുപോലെ Meta-യുടെ ഔദ്യോഗിക ഗ്യാരണ്ടികളും ഇല്ല.
- ഓരോ കീയ്ക്കും മിനിറ്റിൽ അറുപത് റിക്വസ്റ്റുകൾ. ബൾക്ക് ജോലികൾ സ്വന്തം വേഗത ശരിയായി നിയന്ത്രിക്കുന്ന ക്യാമ്പയിനുകളിലാണ് വേണ്ടത്, ഒരു തിരക്കിട്ട API ലൂപ്പിലല്ല.
- മുകളിലുള്ള എൻഡ്പോയിന്റ് ലിസ്റ്റാണ് ഇന്നത്തെ മുഴുവൻ ഇന്റർഫേസ്. അതിൽ ഇല്ലാത്തതൊന്നും ലഭ്യമല്ല, ഡോക്യുമെന്റ് ചെയ്യാത്ത ഒരു എൻഡ്പോയിന്റിനെയും ആശ്രയിക്കരുത്.
- ഒരു കീ സ്കോപ്പുള്ളതാണ്, പക്ഷേ ഓരോ ഉപയോക്താവിനും പ്രത്യേകമല്ല. ഇതിനെ വർക്ക്സ്പേസ് ക്രെഡൻഷ്യലുകളായി കണക്കാക്കുക, ആക്സസുള്ള ആരെങ്കിലും പോകുമ്പോൾ ഇത് മാറ്റുക.
- ഒരിക്കലും സമ്മതം നൽകാത്ത ആളുകൾക്ക് മെസേജ് അയച്ചാൽ, മെസേജ് ഏത് വഴിയിലൂടെ പോയാലും WhatsApp ആ നമ്പർ പരിമിതപ്പെടുത്തും.
ബന്ധപ്പെട്ടത്: Spun WhatsApp-മായി എങ്ങനെ കണക്ട് ചെയ്യുന്നു