IngiaAnza kipindi cha majaribio bila malipo
easyCoexistence API rasmi

Jinsi ya kuwaruhusu watumiaji wako kuunganisha akaunti za WhatsApp, Instagram na TikTok kwenye programu yako

Ili kuwaruhusu watumiaji wako kuunganisha akaunti za WhatsApp, Instagram na TikTok kwenye programu yako, tengeneza kipindi cha kuunganisha kupitia Partner API ya easyCoexistence, kisha mpeleke mtumiaji kwenye URL yake iliyopangishwa. Huko anaunganisha nambari ya WhatsApp kupitia Embedded Signup ya Meta, au anaingia kwenye Instagram, Facebook, TikTok, YouTube, LinkedIn na chaneli nyingine nyingi, kisha arejee kwenye redirect_url yako pamoja na kitambulisho kipya cha muunganisho au cha chaneli. Viungo hudumu saa moja.

1 hour

Muda ambao kiungo cha kuunganisha hufanya kazi; baada ya hapo kipindi kinaonyesha kimeisha muda na kipya kinahitajika.

50 open

Vipindi vya kuunganisha ambavyo akaunti moja inaweza kuwa navyo wazi kwa wakati mmoja, pamoja na kikomo cha vipindi 100 vipya kwa saa.

5 statuses

Kipindi huundwa, hufunguliwa, huunganishwa, hughairiwa au huisha muda, kama GET /connect-sessions/:id inavyoonyesha.

200 characters

URL mbadala ya callback ndefu zaidi ambayo Meta inakubali kwa kuelekeza webhook za ujumbe wa nambari ya WhatsApp kwingine.

Kiungo cha kuunganisha hufanyaje kazi?

Kama ukurasa wa malipo. Backend yako huunda kipindi, kiolesura chako kinamtuma mteja kwenye URL yake, mteja anaunganisha kwenye ukurasa wa easycoexistence.com, na kivinjari kinarudi kwenye redirect_url yako. Kisha backend yako inathibitisha matokeo na kupata sifa za muunganisho mpya, zote kwa kutumia API key yako.

1CreatePOST /connect-sessions from your backend
2SendA redirect or a new tab to the session's url
3ConnectMeta's Embedded Signup, or the network's own sign-in
4ReturnYour redirect_url, with the session, status and new id
5ConfirmGET /connect-sessions/:id, then the credentials

Ombi linajumuisha nini?

Mwili wa JSON unaotumwa kwa https://easycoexistence.com/api/v1/connect-sessions, ukiwa na API key yako kama Bearer token. redirect_url pekee ndiyo inahitajika:

  • redirect_url: URL ya https ambapo mteja anatua baadaye.
  • channel: whatsapp, chaguo-msingi, au mtandao wa kijamii unaofunguliwa kwa akaunti yako, kwa jina lake la herufi ndogo, kama instagram, tiktok au youtube.
  • external_ref: kitambulisho chako mwenyewe cha mteja huyu, hadi herufi 200.
  • partner_name: jina ambalo ukurasa wa kuunganisha unaonyesha, hadi herufi 80; jina la akaunti yako kwa chaguo-msingi.
  • webhook_url pamoja na webhook_verify_token: kwa nambari tu, na daima pamoja. Meta inapeleka ujumbe wa nambari huko tangu muunganisho unapokamilika.
Create a session for a WhatsApp number
curl -X POST https://easycoexistence.com/api/v1/connect-sessions \
  -H "Authorization: Bearer $EC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "whatsapp",
    "redirect_url": "https://app.example.com/connect/return",
    "external_ref": "customer_4821",
    "partner_name": "ClinicApp",
    "webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
    "webhook_verify_token": "another-long-random-string"
  }'

Nini kinarudi?

Jibu la 201 pamoja na kipindi. Mpeleke mteja kwenye url, na uhifadhi id, inayoanza na cs_, ili utafute kipindi baadaye. expires_at ni saa moja baada ya kuundwa, na connection_id au channel_id hujazwa mteja anapounganisha, kulingana na chaneli ya kipindi. GET /connect-sessions/:id hurudisha umbo lile lile wakati wowote.

201 Created
{
  "id": "cs_…",
  "url": "https://easycoexistence.com/connect/cs_…",
  "channel": "whatsapp",
  "status": "created",
  "external_ref": "customer_4821",
  "connection_id": null,
  "channel_id": null,
  "token_ready": false,
  "redirect_url": "https://app.example.com/connect/return",
  "webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
  "last_error": null,
  "expires_at": "2026-10-31T15:00:00.000Z",
  "opened_at": null,
  "finished_at": null,
  "created_at": "2026-10-31T14:00:00.000Z"
}

Ni hitilafu zipi kuunda kipindi kunaweza kurudisha?

Kila hitilafu ina mwili uleule, kitu chenye code na message, na message inaeleza kinachopaswa kurekebishwa. Kuunda kipindi kunaweza kurudisha:

  • 400 invalid_json au invalid_request: mwili si kitu cha JSON, au sehemu imeshindwa uthibitishaji, kama redirect_url isiyo https.
  • 400 channel_unavailable: chaneli haijafunguliwa kwa akaunti hii; message inaorodhesha zilizofunguliwa.
  • 401 unauthorized: API key haipo au si sahihi.
  • 402 billing_required: akaunti haina kadi bado, na kila kitu kilichounganishwa kupitia hiyo hutozwa kwenye akaunti hiyo.
  • 429 cap_reached: vipindi 50 tayari viko wazi; subiri baadhi vimalizike au viishe muda.
  • 429 rate_limited: zaidi ya vipindi 100 saa hii; message inaeleza muda wa kusubiri.

Mteja anatua wapi baadaye?

Kwenye redirect_url yako, pamoja na matokeo yaliyoongezwa kwenye query string yake. Matokeo hayo hayo yako kwenye kipindi, ambacho backend yako inasoma kwa GET /connect-sessions/:id:

  • session: kitambulisho cha kipindi, cs_ ikifuatiwa na herufi za nasibu.
  • status: connected, au cancelled mteja akichagua 'Cancel and go back'.
  • external_ref: kitambulisho chako cha mteja, kipindi kilipobeba kimoja.
  • connection_id: kitambulisho cha nambari mpya, kwa /connections.
  • channel_id: kitambulisho cha akaunti mpya ya mtandao wa kijamii, kwa /channels.
A number connected
https://app.example.com/connect/return?session=cs_…&status=connected&external_ref=customer_4821&connection_id=…

Kipindi kinaweza kuwa na hali zipi?

Tano. GET /connect-sessions/:id hutoa hali ya sasa, pamoja na opened_at, finished_at na last_error, ambayo inaeleza kwa nini jaribio la mwisho lilishindwa:

  • created: kimeundwa na backend yako, bado hakijafunguliwa.
  • opened: mteja amepakia ukurasa wa kuunganisha.
  • connected: nambari au akaunti ya mtandao wa kijamii imeunganishwa, na kitambulisho chake kiko kwenye kipindi.
  • cancelled: mteja alitoka kupitia 'Cancel and go back'.
  • expired: saa moja iliisha kabla kipindi hakijakamilika.

Kiungo kinafanya kazi kwa muda gani?

Saa moja tangu kuundwa. Baada ya hapo ukurasa wa kuunganisha unamwambia mteja kwamba kiungo kimeisha muda, pamoja na kitufe cha kurudi kwenye redirect_url yako chenye status=cancelled, na kipindi kinaonyesha expired. Akaunti inaweza kushikilia vipindi 50 vilivyo wazi na kuunda 100 kwa saa, kwa sababu Meta inahesabu kila uanzishaji wa mara ya kwanza dhidi ya kikomo cha programu nzima kinachoshirikiwa na akaunti zote.

external_ref inafanya nini?

Inaunganisha kila muunganisho na mteja wako. Thamani unayotuma inahifadhiwa kwenye nambari au chaneli ambayo kipindi kinaunda, inaongezwa kwenye uelekezaji upya na kujumuishwa kwenye kila tukio la hali kuihusu, hivyo GET /connections?external_ref=customer_4821 na GET /channels?external_ref=customer_4821 zinaorodhesha alichounganisha mteja huyo. Kuingia kwa Facebook au LinkedIn kunaweza kuleta kurasa kadhaa kwa mara moja: uelekezaji upya unataja ya kwanza, na kichujio kinaorodhesha zilizobaki. Tumia kitambulisho thabiti kutoka kwenye hifadhidata yako, si barua pepe inayoweza kubadilika.

Mteja akighairi au kuingia kukishindwa?

Inategemea mahali ilipotokea, na kipindi huhifadhi rekodi:

  • Dirisha ibukizi la Meta linashindwa au limefungwa: mteja abonyeze 'Connect' tena kwenye ukurasa uleule kiungo kikiwa wazi.
  • Kuingia kwenye mtandao wa kijamii kumeghairiwa au kukataliwa: mteja anarudi kwenye ukurasa wa kuunganisha na sababu, na anaweza kujaribu tena hadi kiungo kiishe.
  • Akaunti tayari imeunganishwa kupitia akaunti nyingine ya easyCoexistence: last_error inasema hivyo, na mteja anaingia kwa akaunti tofauti.
  • Mteja anachagua 'Cancel and go back': redirect_url yako inapata status=cancelled na kipindi kinafungwa, hivyo unda kipindi kipya kwa jaribio jingine.
  • Kiungo kiliisha muda: unda kipindi kipya.

Nini kikitokea nambari ikiunganishwa bila token ya mteja?

Wakati mwingine Meta inamaliza Embedded Signup bila kutoa token ya biashara ya mteja. Ukurasa wa kuunganisha basi unaomba mzunguko mmoja zaidi, unaochukua sekunde chache. Mteja akiruka hatua hiyo, kipindi kinaonyesha connected na token_ready false, na URL yako ya matukio inapokea connection.token_missing: nambari inapokea ujumbe, kwa sababu vitambulisho vyake ni sahihi, lakini haiwezi kutuma hadi kipindi kipya cha kuunganisha kiiunganishe upya na kutoa token.

Nini kikitokea webhook_url ikishindwa ukaguzi wa Meta?

Nambari bado inaunganishwa. Meta inakagua webhook_url kwa ukaguzi wa GET, ambao endpoint yako hupita kwa kurudisha hub.challenge hub.verify_token inapolingana. Ikishindwa, last_error kwenye kipindi kinaanza na webhook_url was not applied na kutoa sababu ya Meta, na PUT /connections/:id/webhook huweka lengwa mara endpoint inapojibu. Ikiwekwa ndani ya saa 24 tangu kuunganisha, bado hupokea uingizaji wa mara moja wa anwani na, mteja akikubali kuishiriki, historia ya gumzo.

Mteja anaona nini?

Ukurasa kwenye easycoexistence.com wenye jina lako kutoka partner_name, na hakuna akaunti, barua pepe wala kadi za kujaza. Kwa nambari ya WhatsApp unaona orodha fupi ya kuthibitisha kustahiki, kisha dirisha ibukizi la Meta na msimbo wa QR wa kuchanganua kwa programu ya WhatsApp Business. Kwa akaunti ya mtandao wa kijamii unaona kitufe kimoja, kama 'Continue with TikTok', kinachofungua skrini ya ridhaa ya mtandao husika kwenye kichupo kile kile, hivyo pia hufanya kazi kwenye simu.

Makosa ya kawaida

  • Kuamini query string pekee. Mtu yeyote anaweza kuandika status=connected kwenye URL, kwa hiyo thibitisha kwa GET /connect-sessions/:id kutoka backend yako kabla ya kumweka mteja kama ameunganishwa.
  • Kuweka kiungo ndani ya iframe. Mpeleke mteja kwa redirect au kichupo kipya, ndivyo ukurasa wa kuunganisha na kuingia kunavyokusudiwa kufanya kazi.
  • Kutengeneza viungo mapema. Kila kimoja hufanya kazi kwa saa moja na kila kilicho wazi kinahesabiwa kwenye kikomo cha 50, kwa hiyo unda kipindi mteja anapokaribia kuunganisha.
  • Kutuma webhook_url yenye herufi zaidi ya 200. Meta inakubali URL mbadala za callback za hadi herufi 200, kwa hiyo ndefu zaidi haitumiki na nambari inaunganishwa bila hiyo.
Kufanya hili ukitumia EasyCoexistence

easyCoexistence inaunganisha nambari za WhatsApp za wateja wako na akaunti zao za Instagram, Facebook, TikTok, YouTube na LinkedIn, pamoja na chaneli nyingine nyingi, kwenye programu yako kupitia kiungo kimoja kilichopangishwa. Kisha inampa backend yako sifa za kila muunganisho, webhook na matukio ya hali yaliyosainiwa. US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, inayoshuka unapoongeza muunganisho, pamoja na siku 3 za kwanza bila malipo.

Maswali yanayoulizwa mara kwa mara

Kiungo kimoja cha kuunganisha kinaweza kutumika mara mbili?

Hapana. Kiungo kinakamilika kwa nambari moja, au kwa kuingia kwa mtandao mmoja wa kijamii, ambao kwenye Facebook au LinkedIn unaweza kuleta kurasa kadhaa. Baada ya hapo kinaonyesha connected, kwa hiyo unda kipindi kipya kwa muunganisho unaofuata.

Naweza kutuma kiungo kwa barua pepe au gumzo?

Ndiyo, mradi mteja akifungue ndani ya saa moja. Kitambulisho cha kipindi kwenye URL ndicho kinachoidhinisha ukurasa, kwa hiyo tuma kila kiungo kwa mteja aliyekitengenezea pekee.

Je, ukurasa wa kuunganisha unafanya kazi kwenye simu?

Kuingia kwa mtandao wa kijamii kunafanya kazi, kwa kuwa hufunguka kwenye kichupo kile kile. Nambari ya WhatsApp inaunganishwa vizuri zaidi kutoka kompyuta: kwenye simu dirisha ibukizi la Meta hufunguka kama kichupo kipya, na simu yenyewe inahitajika kuchanganua msimbo wa QR.

Ninawezaje kujua mteja ameunganishwa bila kuuliza mara kwa mara?

Weka URL ya matukio ya hali kwenye dashboard chini ya Profile, Developers. Kisha easyCoexistence inatuma connection.connected au channel.connected, zikiwa zimesainiwa na zikibeba external_ref yako, mara tu muunganisho unapokamilika.

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