Akaunti na miunganisho
Unganisha mfumo wa nje au msaidizi
Unda ufunguo wa Pro au Agency wenye mipaka ya ruhusa, chapisha maudhui mapya au unganisha msaidizi.
Kabla ya kuanza
Webhook hupokea taarifa za ujumbe kutoka huduma ya WhatsApp. Usanidi wa seva ni wa msimamizi wa muunganisho; watumiaji wa dashibodi hawahitaji kuubadili. MCP huruhusu msaidizi kuomba zana za akaunti.
Hatua za kufuata
- Kwa ujumbe unaoingia, fungua Mipangilio na upate URL ya Webhook.
- Chagua Nakili kupata anwani halisi ya usakinishaji wa akaunti.
- Omba msimamizi kusanidi matukio ya kifaa unachotaka kwa anwani hiyo.
- Panga ujumbe wa majaribio kutoka nambari yako msimamizi akithibitisha kuwa tayari.
- Kagua matokeo, kama jibu linalolingana au ujumbe mpya wa kikundi ukirekodiwa na Kumbukumbu kuwashwa.
- Kwa msaidizi, ingia kupitia skrini ya idhini iliyofunguliwa na programu yako ya MCP.
- Kagua jina la programu na akaunti kabla ya kuidhinisha.
- Kwa muunganisho wa kutuma nje, fungua Mipangilio → Miunganisho ya nje. Unda ufunguo wenye jina kwa akaunti moja iliyounganishwa na vikundi vilivyochaguliwa mahususi. Hifadhi ufunguo mara moja; unaonyeshwa mara moja tu. Nakili URL ya msingi ya API.
- Mfano: Sanidi Abacus.AI itengeneze maudhui mapya katika kila mojawapo ya nyakati nane za uchapishaji za kila siku katika America/Sao_Paulo. Tuma kila chapisho kwenye vikundi vitatu vinavyoruhusiwa kwa Idempotency-Key mpya. Tumia tena ufunguo huo tu unapojaribu tena ombi lilelile kabisa.
- Acha scheduled_at ili kuweka kwenye foleni mara moja, au tumia muhuri kamili wa muda wenye -03:00 au Z (UTC), hadi siku 30 zijazo. Kichakataji hukagua kila dakika; scheduled_at ni muda wa kwanza unaostahili, bila hakikisho la kufikishwa katika sekunde kamili.
- Kagua hali ya kazi na matokeo ya kila kikundi kabla ya kujaribu tena. Ghairi tu utumaji ambao bado haujaanzishwa. Batilisha ufunguo uliovuja katika Mipangilio, kisha unda na uhifadhi mbadala; kazi za zamani haziendelei kwa ufunguo mpya.
Mfano kamili
Maombi yenye thamani za mfano; badilisha ID na uchague tarehe ya baadaye kabla ya kutuma. Maombi haya huchapisha ujumbe halisi. curl '<API_BASE_URL>/v1/groups' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-0900' -H 'Content-Type: application/json' --data '{"type":"text","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"text":"Updated publication","scheduled_at":"2026-10-16T09:00:00-03:00"}' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-1200' -F 'payload={"type":"image","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"caption":"Updated caption"}' -F 'image=@publication.png;type=image/png' curl '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X DELETE '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>'
Jinsi ya kuthibitisha matokeo
Kukubaliwa kwa kazi na matokeo ya vikundi yaliyokubaliwa huthibitisha kupokelewa na lango. Havithibitishi kufikishwa au kusomwa. Kazi zilizopangwa zinaweza kuzuiwa ikiwa ufikiaji, ufunguo, akaunti au ruhusa za vikundi zitabadilika.
Mambo ya kujua
- Wasaidizi wanaweza kusoma rekodi zinazotolewa na kutuma maandishi ukiomba. Soma mwongozo wa zana za msaidizi kabla ya kutuma.
- Tumia dashibodi kwa kuhariri kusikopatikana kupitia MCP.
- Ufikiaji wa API umejumuishwa katika mipango ya Pro na Agency ya kila mwezi au kila mwaka. Starter inahitaji kuboreshwa. Funguo huruhusu akaunti na vikundi vilivyochaguliwa tu; kubadilisha akaunti ya WhatsApp huzuia utumaji. Usishiriki kamwe taarifa za kuingia kwenye seva.
- Maandishi yanaruhusu herufi 4,096; maelezo ya picha 1,024. Pakia JPEG, PNG au WebP ya hadi 5 MiB kupitia sehemu za multipart zinazoitwa payload na image. URL za picha za mbali hazikubaliwi.
- Kazi mpya hurudisha HTTP 202. Jaribio la ombi lilelile lenye Idempotency-Key ileile hurudisha kazi ya awali kwa HTTP 200; maudhui tofauti yenye ufunguo uleule hurudisha 409. Kuisha kwa muda wa kusubiri baada ya kuanza kutuma kunaweza kutothibitishwa; usitume tena kiotomatiki kwa ufunguo mwingine.
Matatizo ya kawaida
- Unachoona
- Hakuna jibu au rekodi mpya baada ya jaribio.
- Cha kufanya
- Kagua muunganisho, sheria au Kumbukumbu, kisha omba msimamizi kuthibitisha usanidi wa matukio yanayoingia.
- Matokeo yanayotarajiwa
- Kipengele kilichosanidiwa sahihi kinaweza kuchakata tukio jipya linalolingana.
- Unachoona
- Msaidizi hawezi kuidhinishwa au ana akaunti tofauti.
- Cha kufanya
- Rudi kuingia na uchague akaunti unayotaka; toa hitilafu za idhini zinazorudiwa kwa msimamizi.
- Matokeo yanayotarajiwa
- Skrini ya idhini na rekodi zinakuwa za akaunti inayokusudiwa.
Pata msaada zaidi
Toa kipengele na hitilafu kwa msimamizi. Usitoe taarifa za siri za seva kwenye mazungumzo ya msaidizi.