તમારી ટીમ જે નંબર પરથી શેર્ડ 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 માં બનાવવાનું, અપડેટ કરવાનું અને લેબલ લગાવવાનું આવે છે.
- 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"
}Spun MCP સર્વર માટે બનાવેલી કી આ API પર જાણીજોઈને નકારવામાં આવે છે, ભલે તે માન્ય કી હોય. બંને ઇન્ટરફેસમાં મંજૂરીના નિયમો અલગ છે, અને એક માટે આપેલી કી ચૂપચાપ બીજા પર વાપરી શકાતી નથી.
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 નંબરને મર્યાદિત કરી દેશે, ભલે મેસેજ ગમે તે રસ્તે ગયો હોય.