IngiaAnza kipindi cha majaribio bila malipo
Meta Tech Provider

WhatsApp API kwa wakala wa AI: ufikiaji rasmi ndani ya dakika, bila kuwa Tech Provider

Wakala wa AI hupata ufikiaji rasmi wa WhatsApp kupitia Cloud API ya Meta, na nambari inayobaki kwenye programu ya WhatsApp Business hujiunga nayo kupitia Tech Provider au Solution Partner. Unaweza kuwa mmoja wao, kwa uthibitishaji wa biashara, video za App Review na toleo la Embedded Signup. Au unaweza kuunganisha kupitia mtoa huduma aliye tayari kuwa hivyo: nambari hujiunga ndani ya dakika chache, na wakala hupata zana za MCP au vitambulisho vya API.

easyCoexistence ni Meta Tech Provider huru: inaunganisha nambari ya WhatsApp Business na Cloud API kupitia Coexistence ndani ya dakika, ili wakala wako apate ufikiaji rasmi huku biashara ikibaki na programu.

Tech Provider

Meta inahitaji nini kwa yeyote anayesajili nambari inayobaki kwenye programu ya WhatsApp Business: hadhi ya Tech Provider au Solution Partner.

2 videos

App Review inauliza video moja ya ujumbe uliotumwa kutoka programu yako, na nyingine ya programu yako ikiunda kiolezo cha ujumbe.

Advanced access

App Review inatoa nini kwa whatsapp_business_messaging na whatsapp_business_management, ruhusa zote mbili zinazohitajika ili kuwa Tech Provider.

October 15, 2026

Meta ilipoondoa Embedded Signup v2 na v3, ikiziagiza programu zinazounganisha kuhamia v4.

20 msg/s

Kasi ya kutuma ujumbe iliyowekwa ya nambari inayotumika kwa programu ya WhatsApp Business na Cloud API kwa wakati mmoja.

1 hour

Muda ambao kiungo cha kuunganisha kilichoandaliwa na jukwaa kinabaki halali pale jukwaa linaposajili nambari ya mteja kupitia Partner API.

Wakala wa AI anahitaji nini ili kutumia WhatsApp rasmi?

Vitu vinne kutoka Cloud API ya Meta. Kitambulisho cha nambari ya simu (phone number ID) na access token yenye ruhusa ya whatsapp_business_messaging, ili wakala aweze kuita endpoint ya messages. Webhook endpoint ambapo Meta huwasilisha ujumbe unaoingia, pamoja, kwenye nambari inayoshirikiwa na programu, na smb_message_echoes kwa majibu ambayo mtu anaandika kwenye simu. Kiolezo cha ujumbe kilichoidhinishwa, kwa sababu ujumbe wa maandishi unafika tu kwa anayeandika ndani ya saa 24 zilizopita. Na njia ya kujua pale muunganisho unapovunjika, kwa kuwa programu kwenye simu huendelea kufanya kazi hata API inaposimama.

Njia ya mkato ambayo watu wanaipata kwanza ni otomatiki ya WhatsApp Web, inayoingia kama kifaa kilichounganishwa. Hiyo inakiuka sheria za WhatsApp na kuweka nambari hatarini ya kufungiwa, bila kujali wakala aliye juu yake anavyofanya kazi.

Njia ya Tech Provider inahusisha nini?

Mfuatano rasmi wa Meta, kwa mpangilio huu. Kila hatua ni bure, na hakuna inayoweza kununuliwa haraka: ukaguzi unafuata ratiba ya Meta, na Meta haichapishi muda maalum, kwa hiyo panga wiki badala ya siku kabla nambari ya mteja wa kwanza haijaunganishwa. Baada ya hapo backend lazima iendelee kufanya kazi: kubadilishana token baada ya kila usajili, kipokezi cha webhook, uelekezaji wa kila nambari, na ufuatiliaji wa kukatika kwa muunganisho, kama sheria ya Meta ya kutokutumika kwa siku 14.

1Business verificationName, address, phone, email and website checked by Meta
2Meta appThe WhatsApp use case and a connected business portfolio
3App ReviewTwo videos, then advanced access to both WhatsApp permissions
4Embedded SignupVersion 4 or later, with WhatsApp Business app onboarding
5Your backendToken exchange, webhooks, routing and monitoring

Njia fupi ni ipi?

Unganisha nambari kupitia mtoa huduma ambaye tayari amepitia mchakato huo. Kwa easyCoexistence, biashara huendesha Embedded Signup ya Meta na kuskani msimbo wa QR kwa programu ya WhatsApp Business, jambo linalochukua dakika mbili hivi. Nambari hujiunga na Cloud API ndani ya Business Portfolio ya biashara yenyewe, huku programu ikiendelea kufanya kazi. Kisha wakala anapata ufikiaji katika lugha anayoelewa: zana za MCP kwa msaidizi kama ChatGPT, Claude, Claude Code au Codex, au vitambulisho na webhooks za nambari kwa msimbo unaouendesha.

Connect through easyCoexistenceBecome a Tech Provider
Meta app and App ReviewNot needed: the number joins through oursYours to build and pass
Embedded SignupHosted, with the QR scan in the appYou integrate version 4 and host the flow
First number connectedMinutes after signing upAfter verification and review
Webhook trustA secret in your URL, or X-EC-Signature on forwarded messagesYour app secret signs Meta's deliveries
Disconnection alertsEvery number watched 24/7, 14-day rule includedMonitoring you build and run
Who owns the WhatsApp Business AccountThe business, in its own portfolioThe business

Wakala anapataje vitambulisho vya nambari?

Kupitia get_api_credentials, au kutoka ukurasa wa nambari kwenye dashboard. Zana inarudisha URL ya msingi ya Graph API, WhatsApp Business Account ID, phone number ID, endpoint ya kutuma, na, pale inapokuwepo, access token ya biashara yenyewe, iliyoidhinishwa kwa mali zake za WhatsApp. Pale client token haikutolewa, token inarudi null pamoja na maelezo kwamba kuunganisha upya nambari kutoka dashboard kunatoa moja, bila kubadilisha token inayofanya kazi. Hakuna app secret ya kuchukua, kwa sababu Meta husaini webhooks kwa app secret ya easyCoexistence, ambayo haishirikiwi kamwe. Zana inahitaji kifurushi kinachofanya kazi, kwa kuwa token inaweza kutuma ujumbe.

Send a reply with the returned credentials
curl -X POST "$SEND_ENDPOINT" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "5511999998888",
    "type": "text",
    "text": { "body": "Your order #1042 is ready for pickup." }
  }'

Jinsi ujumbe unaoingia unavyomfikia wakala?

Kila nambari ina hali mbili, zinazobadilishwa na set_inbound_mode au kwenye ukurasa wa nambari. Moja kwa moja kwenye seva yako: set_webhook_destination inaelekeza Meta moja kwa moja kwenye HTTPS endpoint yako, ambayo lazima ijibu uthibitisho wa GET wa Meta, na easyCoexistence haioni ujumbe kamwe, kwa hiyo otomatiki zimezimwa. Kwa kuwa Meta husaini uwasilishaji huo kwa app secret yetu, weka siri ndefu isiyo na mpangilio kwenye njia ya URL na kataa maombi yasiyo nayo.

Otomatiki zimewashwa: Meta huwasilisha kwa easyCoexistence, otomatiki zinaweza kujibu, na Forward URL ya hiari hupokea payload asili ya Meta chini ya "value", ikisainiwa na X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 ya "<t>.<body>"> kwa kutumia siri inayoonyeshwa mara moja. Hatua ya "Call my webhook" ya otomatiki pia humpa wakala wako ujumbe pamoja na jumbe 10 za mwisho za gumzo, na hutuma jibu lake pale jibu lako ni {"reply": "..."} ndani ya sekunde 20.

Wakala lazima azingatie vikomo gani?

Vya Meta, na ni vilevile kupitia mtoa huduma yeyote. Wakala anayevijua mapema huepuka hitilafu zinazoonekana kama buggi:

  • Ujumbe 20 kwa sekunde kwa kila nambari, uliowekwa na Meta kwa nambari zinazoshirikiwa na programu ya WhatsApp Business.
  • Ujumbe ulioandikwa tu ndani ya saa 24 tangu ujumbe wa mwisho wa mteja; baada ya hapo, kiolezo kilichoidhinishwa.
  • Violezo vinatumwa kupitia API pekee, kwa sababu programu kwenye nambari ya Coexistence haiwezi kuvituma.
  • Majibu ambayo mtu anaandika kwenye programu yanafika kama smb_message_echoes; simamisha wakala kwenye gumzo hilo, la sivyo mteja atapokea majibu mawili.
  • Gumzo za vikundi hazisawazishwi kwenye API, kwa hiyo wakala hufanya kazi kwenye gumzo za mtu kwa mtu.
  • Anwani na gumzo za mtu kwa mtu hadi miezi 6 huingizwa mara moja, tu ikiwa lengwa la webhook la moja kwa moja limehifadhiwa ndani ya saa 24 tangu kuunganisha; nambari yenye otomatiki zimewashwa haipati uingizaji huo.
  • Simu za sauti na video zinaendelea kufanya kazi kwenye programu, lakini Cloud API haibebi simu kwenye nambari ya Coexistence, kwa hiyo wakala hufanya kazi kwa maandishi.

Je, jukwaa linaweza kuunganisha nambari za wateja wake kwa njia hii?

Ndiyo, kupitia Partner API, ambayo ndiyo njia ambayo SaaS au wakala hutumia kusajili wateja wake bila hadhi yake ya Tech Provider. Tengeneza ufunguo kwa create_api_key (unaanza na ec_live_ na huonyeshwa mara moja), kisha uite POST /api/v1/connect-sessions kutoka backend yako, au create_connect_link kutoka kwa msaidizi, ili upate kiungo kilichoandaliwa halali kwa saa 1. Mteja anaendesha dirisha ibukizi la Meta na kuskani msimbo wa QR hapo, kisha anarudi kwenye redirect_url yako na connection_id. GET /api/v1/connections/:id?credentials=1 kisha inarudisha token ya mteja mwenyewe, na matukio ya hali kama connection.disconnected yanafika yakisainiwa kwa X-EC-Signature. Kila nambari inatozwa kwenye akaunti yako kwa madaraja yale yale ya kila nambari.

Makosa ya kawaida

  • Kuthibitisha X-Hub-Signature-256 kwenye lengwa la moja kwa moja. Meta husaini kwa app secret ya easyCoexistence, ambayo haishirikiwi kamwe, kwa hiyo uwasilishaji halisi unashindwa ukaguzi; amini siri ndefu isiyo na mpangilio kwenye URL, au tumia usambazaji na X-EC-Signature.
  • Kupokea kwa nodi ya WhatsApp Trigger ya n8n. Inatarajia app yako mwenyewe ya Meta; tumia nodi ya jumla ya Webhook yenye siri kwenye URL yake badala yake.
  • Kupuuza smb_message_echoes. Wakala basi hujibu juu ya mtu ambaye tayari alijibu kutoka simuni, na mteja anasoma majibu mawili.
  • Kuhifadhi lengwa la webhook la moja kwa moja siku kadhaa baada ya kuunganisha, au kuacha nambari kwenye otomatiki. Uingizaji wa mara moja wa Meta wa anwani na gumzo hadi miezi 6 unahitaji lengwa la moja kwa moja lililohifadhiwa ndani ya saa 24 tangu muunganisho.
Kufanya hili ukitumia EasyCoexistence

Wakala hufanya kazi kupitia zana zaidi ya 30 za MCP au kupitia vitambulisho na webhooks za kila nambari, na kila nambari inafuatiliwa 24/7 kwa arifa. Kuanzia US$ 9 kwa kila nambari iliyounganishwa kwa mwezi hadi US$ 0.75 kadri unavyoongeza nambari, pamoja na kipindi cha majaribio bila malipo cha siku 3.

Maswali yanayoulizwa mara kwa mara

Je, ninahitaji programu yangu ya Meta?

Hapana. Nambari inasajiliwa kupitia programu ya Meta ya easyCoexistence na inabaki kwenye Business Portfolio ya biashara na WhatsApp Business Account yake. Msimbo wako hutuma kwa token ya biashara yenyewe kutoka get_api_credentials, kwa hiyo hakuna programu yako inayohusika, isipokuwa baadaye ukiunda moja.

Je, wakala na timu wanaweza kutumia nambari kwa wakati mmoja?

Ndiyo. Meta huakisi ujumbe kati ya Cloud API na programu ya WhatsApp Business, kwa hiyo kile wakala anachotuma kinaonekana kwenye uzi wa gumzo wa programu kwenye simu, na kile timu inachoandika kwenye programu hufika kwenye mfumo wako kama smb_message_echoes.

Ni mifumo gani ya wakala inayofanya kazi nayo?

Kila kiteja kinachozungumza MCP kupitia HTTP kwa OAuth, kama ChatGPT, Claude, Claude Code, Codex na Cursor, na msimbo wowote unaoita Graph API ya Meta: Node.js, Python, n8n, LangChain, OpenAI Agents SDK au Vercel AI SDK. API iliyo chini ni ya Meta yenyewe, kwa hiyo hakuna kitu cha umiliki kilichomo ndani ya wakala.

Je, msaidizi wa AI wa madhumuni ya jumla anaruhusiwa kwenye WhatsApp?

Masharti ya Business Solution ya Meta, kifungu cha 4.7, yanazuia watoa huduma wa wasaidizi wa AI wa madhumuni ya jumla kuwatoa kwenye WhatsApp Business Platform pale AI ndiyo kazi kuu, kama Meta inavyoamua, yakianza kutumika tarehe 15 Januari 2026. Biashara inayotumia AI kwa wateja wake, kwa msaada, mauzo au uhifadhi wa nafasi, si lengo la kanuni hiyo, na wadhibiti katika EU na Brazili wameiagiza Meta kusimamisha au kurudisha nyuma kanuni hiyo kwa wasaidizi washindani.

Endelea kusoma

Uko tayari kuanza?

Sanidi WhatsApp Coexistence kwa dakika chache, si miezi. Programu inaendelea kufanya kazi kwenye simu.

Anza kipindi cha majaribio bila malipo

Imethibitishwa kwenye