Jinsi ya kuongeza WhatsApp kwenye SaaS yako kwa Embedded Signup na Coexistence
SaaS huongeza WhatsApp kwa kuunganisha nambari iliyopo ya kila mteja kupitia Embedded Signup ya Meta pamoja na Coexistence, ili nambari iendelee kufanya kazi kwenye programu ya WhatsApp Business. Kwa Partner API ya easyCoexistence, kipindi kimoja cha muunganisho kwa kila mteja kinaendesha mchakato huu kwenye ukurasa ulioandaliwa, Meta hupeleka ujumbe wa nambari hiyo kwenye webhook_url yako, na backend yako hujibu kupitia Cloud API kwa kutumia token ya mteja mwenyewe.
Kasi isiyobadilika ya nambari inayotumiwa na programu ya WhatsApp Business na Cloud API kwa wakati mmoja.
Toleo la zamani zaidi la programu ya WhatsApp Business ambalo nambari ya mteja inaweza kuunganishwa nalo kupitia Coexistence.
Muda wa nyuma ambao historia ya mazungumzo ambayo Meta inaweza kushiriki wakati wa kuanza inafikia; lazima isawazishwe ndani ya saa 24.
Dirisha la huduma kwa wateja la WhatsApp baada ya ujumbe au simu ya mtumiaji; kila ujumbe mpya huliweka upya.
Tarehe ambayo Meta iliacha kutumia Embedded Signup v2 na v3, na miunganisho ikahamishwa kwenda v4.
Sehemu za muunganisho wa WhatsApp ni zipi?
Tano, na easyCoexistence inachukua ya kwanza na ya mwisho. Bidhaa yako inashikilia mantiki ya mazungumzo, kikasha na chochote ambacho modeli yako au wafanyakazi wa wateja wanaandika, huku Meta ikibeba ujumbe kati ya nambari na seva yako:
Coexistence inabadilisha nini kwa wateja wako?
Wanabaki na nambari yao na simu yao. Programu ya WhatsApp Business inaendelea kufanya kazi pamoja na Cloud API, hivyo wafanyakazi hujibu kwenye simu huku bidhaa yako ikijibu kupitia API, na kile wanachotuma kutoka kwenye programu kinafika kwenye webhook yako kama smb_message_echoes. Mipaka mitatu huambatana nayo: nambari hutuma kwa kasi isiyobadilika ya ujumbe 20 kwa sekunde, ni API pekee inayoweza kutuma template, na Meta hukata nambari ikikaa bila kutumika kwa takriban siku 14.
Hatua ya kuunganisha inaonekanaje kwenye bidhaa yako?
Kitufe cha Connect WhatsApp kinaita POST /connect-sessions kutoka backend yako chenye redirect_url, id ya mteja wako kama external_ref, na webhook_url pamoja na webhook_verify_token, ili Meta ielekeze nambari kwako tangu dakika ya kwanza. Mteja huthibitisha orodha fupi kwenye ukurasa ulioandaliwa, hufungua dirisha ibukizi la Meta, huchanganua msimbo wa QR kwa programu ya WhatsApp Business, kisha anarudi kwako na connection_id. Iwapo utaendesha Embedded Signup kutoka programu yako mwenyewe ya Tech Provider badala yake, hilo linapimwa kwenye mwongozo wa Embedded Signup.
Ujumbe unafikiaje backend yako?
Kutoka Meta moja kwa moja hadi webhook_url, bila kupitia easyCoexistence na bila nakala yoyote kuhifadhiwa. Sehemu ya messages hubeba kile wateja wanachotuma na hali ya kile unachotuma, na smb_message_echoes hubeba kile wafanyakazi wanachotuma kutoka programu. Meta husaini kila uwasilishaji kwa siri ya programu ya easyCoexistence, ambayo haishirikiwi kamwe, hivyo siri ndefu isiyo ya kawaida kwenye njia ya URL ndiyo inayoithibitisha. Nambari mbili kwenye akaunti moja ya WhatsApp Business hushiriki lengo moja: elekeza kwa value.metadata.phone_number_id.
Backend yako inajibuje na kutuma template?
Kwa Graph API ya Meta na token ya mteja kutoka GET /connections/{id}?credentials=1, ambayo pia hurudisha send_endpoint. Maandishi huru hutumwa ndani ya saa 24 tangu ujumbe wa mwisho wa mtu; baada ya hapo, ni template ambayo Meta imeidhinisha pekee ndiyo inayopita:
- Jibu: POST /<
PHONE_NUMBER_ID>/messages chenye type text, ndani ya dirisha. - Template: wito uleule chenye type template, jina la template na msimbo wa lugha yake.
- Unda template: POST /<
WABA_ID>/message_templates, kisha kagua hali yake mara kwa mara, kwa sababu matokeo ya ukaguzi hayafiki kwenyewebhook_urlyako. - Media: POST /<
PHONE_NUMBER_ID>/media kupakia; media inayoingia hufika kama ID ya kuchukua kwa token ile ile.
curl -X POST "$SEND_ENDPOINT" \
-H "Authorization: Bearer $CUSTOMER_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5511987654321",
"type": "text",
"text": { "body": "Your table for 4 is booked for 8 pm." }
}'Bidhaa yako inaweza kuingiza mazungumzo yaliyopo ya mteja?
Mara moja tu, wakati wa muunganisho. Webhook_url ikiwekwa kwenye kipindi, easyCoexistence humwomba Meta kutuma anwani za nambari na, iwapo mteja atakubali kwenye programu, hadi siku 180 za mazungumzo, ambazo hufika kama webhook zote za smb_app_state_sync na history. Meta inaruhusu hilo ndani ya saa 24 tangu muunganisho, kwa hiyo hakikisha endpoint inajibu kabla kiungo hakijatumwa. Mwongozo wa historia ya mazungumzo unaeleza payload.
Nani analipa Meta kwa ujumbe?
Mteja wako. Meta humtoza ujumbe unaotumwa na backend yako kupitia API kwenye akaunti ya WhatsApp Business ya mteja huyo, kwa njia ya malipo anayoweka huko, na biashara isiyo na njia hiyo haiwezi kutuma template za matangazo. easyCoexistence humtoza akaunti yako kwa kila nambari iliyounganishwa, bila kutoza ujumbe wowote na bila kuweka nyongeza ya bei kwenye bei za Meta.
Nini hutokea nambari inapoacha kufanya kazi?
URL yako ya matukio hupokea connection.disconnected pamoja na sababu ya Meta inapojulikana. PRIMARY_INACTIVITY ni kanuni ya siku 14, na kipindi kipya cha muunganisho kwa mteja huyo hurudisha nambari ile ile. connection.token_missing inamaanisha nambari iliyounganishwa bila token ya mteja, kwa hiyo hupokea ujumbe lakini haiwezi kutuma hadi kipindi kipya kiiunganishe upya.
Makosa ya kawaida
- Kutuma kiungo cha muunganisho kabla endpoint yako ya webhook haijajibu. Uingizaji wa historia hufanyika mara moja tu, ndani ya saa 24 tangu muunganisho, na maudhui yaliyotumwa kabla URL yako haijafanya kazi yanapotea.
- Kujibu kwa maandishi huru baada ya dirisha kufungwa. Saa 24 zikipita tangu ujumbe wa mwisho wa mtu, ni template iliyoidhinishwa pekee inayopita.
- Kuendesha kampeni kutoka nambari moja kwa kasi kamili. Nambari ya Coexistence hutuma kwa ujumbe 20 kwa sekunde, kwa hiyo panga foleni ya kutuma ya kila nambari kwa kasi hiyo.
- Kutarajia wafanyakazi watume template kutoka simu. Kwenye Coexistence ni API pekee inayoweza kuzituma, kwa hiyo weka utumaji wa template ndani ya bidhaa yako.
easyCoexistence huongeza WhatsApp kwenye SaaS yako kwa Embedded Signup ya Meta na Coexistence, kupitia ukurasa ulioandaliwa unaoonyesha jina lako: wateja wanabaki na nambari yao na programu ya WhatsApp Business, Meta huwasilisha ujumbe kwenye seva yako, na matukio yaliyosainiwa hukufikia. API hiyo hiyo huunganisha Instagram, Facebook, TikTok, YouTube, LinkedIn na njia nyingine zaidi. Kuanzia US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, bei ikishuka unavyoongeza muunganisho, na kipindi cha majaribio bila malipo cha siku 3.
Maswali yanayoulizwa mara kwa mara
Je, mteja anaweza kuunganisha nambari iliyo kwenye mtoa huduma mwingine wa API ya WhatsApp?
Hapana, si wakati nambari bado iko huko. Orodha ya ukurasa ulioandaliwa inaomba nambari isiwe na mtoa huduma mwingine wa API au zana ya otomatiki, kwa hiyo mteja anaiondoa kwanza kwa mtoa huduma huyo.
Je, SaaS yangu inaweza kutuma template za WhatsApp kwa wateja wake?
Ndiyo, kupitia Cloud API kwa kutumia token ya kila mteja: tengeneza template kwenye akaunti ya WhatsApp Business ya mteja, subiri ukaguzi wa Meta, kisha itume.
Je, easyCoexistence inasoma ujumbe wa WhatsApp wa wateja wangu?
Hapana. Meta huwasilisha ujumbe wa nambari moja kwa moja kwenye webhook_url uliyoweka. Nambari isiyo na webhook_url hutumia callback ya easyCoexistence badala yake, ambapo ujumbe hutupwa bila kuhifadhiwa.
easyCoexistence inagharimu kiasi gani kwa kila nambari ya WhatsApp?
Kuanzia US$ 9 hadi US$ 0.75 kwa kila nambari kwa mwezi, kulingana na kiwango cha jumla cha muunganisho wako, na siku 3 za kwanza bila malipo. Gharama za ujumbe za Meta huenda kwa akaunti ya WhatsApp Business ya kila mteja.
Endelea kusoma
Unganisha chaneli yako ya kwanza ndani ya dakika mbili.
Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.
- Siku 3 bila malipo
- Ghairi wakati wowote
- API rasmi pekee
- Hufuatiliwa saa 24/7
Imethibitishwa kwenye