Mpe msaidizi wa AInambari halisi ya WhatsApp.
MCP server huwezesha Claude, ChatGPT au Cursor kutumia WhatsApp moja kwa moja: kuorodhesha nambari zako, kukagua hali yake, kutuma jumbe na violezo, na kuelekeza webhook kwenye mifumo yako mwenyewe. Yetu huendeshwa kwenye Cloud API rasmi ya Meta, kwa hiyo nambari ambayo wateja wako tayari wanaitumia kukutumia ujumbe haiko hatarini kamwe.
{
"mcpServers": {
"easycoexistence": {
"url": "https://easycoexistence.com/api/mcp"
}
}
}Connector inaunganishwa na nini hasa
Server moja ya mbali, inayofikiwa kupitia OAuth, inayoita Cloud API ya Meta iliyoandikiwa nyaraka kwenye nambari ambayo bado inatumika katika programu ya WhatsApp Business. Hakuna kipindi kinachoshikiliwa popote na hakuna kinachoendeshwa kwenye mashine yako.
- 1Msaidizi wakoClaude, ChatGPT, Cursor au Claude Code, kupitia MCP
- 2easycoexistence.com/api/mcpYa mbali, imeidhinishwa kwa OAuth. Hakuna ufunguo unaobandikwa popote
- 3Meta Cloud APIEndpoint za Graph zilizoandikiwa nyaraka, kwa token ya akaunti yenyewe
- 4Nambari ya biasharaImeunganishwa kupitia Coexistence, programu bado inafanya kazi kwenye simu
Njia mbadala ambayo otomatiki nyingi za WhatsApp hutumia ni kuingia kama kifaa kilichounganishwa na kuendesha kipindi cha WhatsApp Web. Hilo linakiuka masharti ya WhatsApp, na Meta hulitambua kutokana na muundo wa trafiki badala ya msimbo unaoituma, ndiyo sababu dai la kuzuia kufungiwa linaeleza jambo ambalo mtoa huduma hawezi kulidhibiti. Hakuna chochote hapa kinachotumia utaratibu huo.
Jinsi ya kuisakinisha
Endpoint moja ya mbali, ileile kwa kila nambari kwenye akaunti. Hakuna kifurushi cha kusakinisha wala ufunguo wa kuzalisha: kila programu huingia kwa OAuth mara ya kwanza inapoita zana.
- Fungua Settings kisha nenda kwenye Connectors.
- Chagua Add custom connector kisha bandika endpoint iliyo hapa chini.
- Hifadhi, kisha mwombe Claude aorodheshe nambari zako. Mara ya kwanza itafungua ukurasa wa kuingia.
https://easycoexistence.com/api/mcp- Fungua Settings, nenda kwenye Connectors, kisha Advanced, na uwashe Developer mode.
- Ongeza connector ukitumia endpoint iliyo hapa chini.
- Anzisha mazungumzo na uombe iorodheshe nambari zako ili kuanzisha kuingia.
https://easycoexistence.com/api/mcp- Endesha amri iliyo hapa chini kwenye terminal yoyote.
- Endesha /mcp ndani ya Claude Code na ujithibitishe.
- Zana hizo zitapatikana katika kila kipindi kuanzia hapo.
claude mcp add --transport http easycoexistence --scope user https://easycoexistence.com/api/mcp- Fungua Settings na utafute sehemu ya MCP.
- Ongeza server ukitumia usanidi ulio hapa chini.
- Pakia upya, kisha mwombe Cursor aorodheshe nambari zako.
{
"mcpServers": {
"easycoexistence": {
"url": "https://easycoexistence.com/api/mcp"
}
}
}Kuunganisha nambari ni hatua tofauti ya mara moja inayohitaji kivinjari, kwa sababu usajili wa Meta hutumia dirisha lake ibukizi na uchanganuzi wa msimbo wa QR. get_connect_link hurudisha kiungo hicho ikiwa ungependa msaidizi akukabidhi.
Sheria ambazo zana hutekeleza, ili msaidizi asijifunze kwa njia ngumu
send_message hufanya kazi pale mpokeaji alipotuma ujumbe kwa nambari hiyo ndani ya saa 24 zilizopita. Majibu hayo ni bila malipo. Nje ya muda huo, send_template na kiolezo kilichoidhinishwa ndicho pekee kinachofika, na maelezo ya zana yanasema hivyo, kwa hiyo msaidizi huchagua zana sahihi bila kuambiwa.
Programu ya simu haiwezi kutuma kiolezo kwenye nambari ya Coexistence. Chochote kilichopangwa, cha miamala au kilicho nje ya dirisha lazima kipitie API, na hiyo ni sehemu kubwa ya sababu nambari huunganishwa kabisa.
Jumbe za masoko hutozwa na Meta kupitia njia ya malipo iliyo kwenye WhatsApp Business Account, inayowekwa katika WhatsApp Manager. Hazipiti kwetu kamwe na hatuwezi kuongeza kadi kupitia API.
HTTPS, na kwenye GET yenye hub.mode=subscribe na hub.verify_token yako, endpoint lazima irudishe hub.challenge. Tunathibitisha kabla ya mwito, kwa hiyo URL yenye hitilafu hushindwa mara moja badala ya kuonekana kama imeunganishwa.
Zana 16 za WhatsApp, na kila moja ni ya kazi gani hasa
Connector moja hutoa zana zote kwa kila nambari kwenye akaunti, pamoja na zana za chaneli nyingine. list_numbers huja kwanza kwa sababu kila zana nyingine ya WhatsApp huchukua connection_id kutoka kwake.
list_numbersNambari zilizounganishwa pamoja na hali, ukadiriaji wa ubora na kiwango cha utumaji. Mahali pa kuanzia kwa kila kitu kingine.get_number_healthPicha ya moja kwa moja kutoka Meta pamoja na mfuatano wa hivi karibuni wa ufuatiliaji: matukio ya webhook na ukaguzi wa mara kwa mara kwa pamoja.get_api_credentialsURL ya msingi ya Graph API, WABA id, phone number id, na token ya ufikiaji ya akaunti yenyewe pale inapopatikana.
send_messageMaandishi huru, na ndani ya dirisha la huduma kwa wateja la saa 24 pekee. Majibu ndani ya dirisha hilo ni bila malipo.send_templateJinsi mazungumzo yanavyoanzishwa na mtu ambaye hajaandika kwanza.list_templatesViolezo vilivyo kwenye akaunti pamoja na hali ya ukaguzi wake.create_templateHuwasilisha kwa Meta kwa ukaguzi. UTILITY, MARKETING au AUTHENTICATION, na vigezo vya mtindo wa {{1}} vinavyohitaji thamani za mfano.get_template_statusAPPROVED, PENDING au REJECTED, kwa jina la kiolezo.
set_webhook_destinationHuelekeza jumbe zinazoingia na nakala kutoka programu ya simu moja kwa moja kutoka Meta hadi kwenye mfumo wako. Tuma null ili kuirejesha.get_connect_linkHurudisha kiungo cha dashboard na hatua za kuunganisha nambari mpya, kwa kuwa usajili unahitaji kivinjari.get_docsNyaraka kamili za bidhaa kama markdown, ili msaidizi ajibu kutoka kwenye nyaraka zetu badala ya kubahatisha.
get_partner_setupHali ya usanidi wa Partner API: malipo, ufunguo wa API, URL ya matukio na hatua inayofuata.create_api_keyHutoa ufunguo wa Partner API na kuuonyesha mara moja tu. Haubadilishi ufunguo uliopo bila uthibitisho wako.revoke_api_keyHubatilisha ufunguo wa Partner API baada ya wewe kuthibitisha. Kuanzia hapo, kila ombi linalotumia ufunguo huo hushindwa.set_partner_events_urlHuweka mahali matukio ya hali ya muunganisho yanapotumwa na kurudisha siri ya kusaini, inayoonyeshwa mara moja tu.create_connect_linkHuunda kiungo cha kuunganisha kinachopangishwa kwa mmoja wa wateja wako, halali kwa saa 1. Namba hiyo hutozwa kwenye akaunti yako.
Kinachoendelea kufanya kazi malipo yanapokwama
Zana zinazochukua hatua nje zinazuiwa, pamoja na get_api_credentials, kwa sababu inatoa token inayotumika kutuma. Kusoma afya na hali kunabaki wazi, kwa makusudi.
list_numbersget_number_healthget_template_statuslist_templatesget_connect_linkget_docsget_partner_setupcreate_api_keyrevoke_api_keyset_partner_events_url
send_messagesend_templatecreate_templateset_webhook_destinationget_api_credentialscreate_connect_link
Akaunti isiyoweza kuona kwa nini imezuiwa, au isiyoweza kukagua kama nambari zake ziko katika hali nzuri, haina njia ya kurudi isipokuwa tiketi ya msaada. Ufuatiliaji wa hali wenyewe pia hutegemea hatua hizo mbili za kusoma.
Jozi muhimu ikiwa unahudumia biashara nyingine
get_connect_link hurudisha kiungo ambacho mteja hufungua ili kuunganisha nambari yake mwenyewe, na set_webhook_destination huielekeza nambari hiyo kwenye mfumo wako mara tu inapounganishwa. Kwa pamoja, zinamaanisha kwamba agent anaweza kumsajili mteja mwanzo hadi mwisho bila mtu yeyote kufungua dashboard.
Akaunti moja inaweza kuwa na nambari nyingi kadiri unavyohitaji, kila moja ikitozwa kivyake, na list_numbers huzirudisha zote pamoja na connection_id ambayo kila zana nyingine huchukua.
Zana za kusoma, kutuma, violezo, kuunganisha, nyaraka na Partner API, zote zimeorodheshwa hapa chini.
Kasi ya kudumu ya kutuma kwa nambari ya Coexistence, iliyowekwa na Meta. Haiwezi kuongezwa, nasi wala wewe.
Muda ambao jibu la mteja huweka kipindi wazi. Nje ya hapo, kiolezo kilichoidhinishwa pekee ndicho kinachoweza kutumwa.
Server iko mbali, kwa hiyo hakuna kinachoendeshwa kwenye mashine yako na hakuna kipindi kinachohifadhiwa popote.
Maswali yanayoulizwa mara kwa mara
Je, nambari ya mteja wangu inaweza kufungiwa kwa sababu ya hili?
Hapana. Hii ni Cloud API rasmi ya Meta, inayofikiwa kupitia kipengele cha Meta cha Coexistence. Hatari ya kufungiwa inayozungumziwa hutoka kwenye njia zisizo rasmi zinazojiingiza kama kifaa kilichounganishwa, ambao ni utaratibu tofauti kabisa.
Muunganisho huu hufanya kazi na wasaidizi gani?
Chochote kinachozungumza MCP kupitia HTTP na OAuth: Claude, ChatGPT, Cursor, Claude Code na Codex leo. Ni endpoint moja ya mbali, kwa hiyo hakuna kinachoendeshwa kwenye mashine yako.
Je, mazungumzo yangu hupitia server zenu?
Si kwa chaguo-msingi. Jumbe zinazoingia hupita kutoka Meta moja kwa moja hadi kwenye webhook unayoteua, nasi hatuhifadhi maudhui yoyote ya mazungumzo. Tunashikilia tu akaunti, hali ya nambari na credentials zinazohitajika kuendesha na kufuatilia muunganisho.
Je, ninaweza kutumia muunganisho mmoja kwa wateja kadhaa?
Ndiyo. Akaunti moja inaweza kuwa na nambari nyingi unazohitaji, kila moja ikitozwa kama muunganisho wake, na muunganisho huziorodhesha zote. Hakuna kizuizi cha kuitumia kwa biashara unazohudumia.
Uko tayari kuanza?
Sanidi WhatsApp Coexistence kwa dakika chache, si miezi. Programu inaendelea kufanya kazi kwenye simu.
Anza kipindi cha majaribio bila malipoSiku 3 bila malipo. Hakuna kinachotozwa hadi kipindi cha majaribio kiishe.