Paano payagan ang inyong mga user na i-connect ang WhatsApp, Instagram at TikTok account sa inyong app
Para payagan ang inyong mga user na i-connect ang WhatsApp, Instagram at TikTok account sa inyong app, gumawa ng connect session gamit ang Partner API ng easyCoexistence at ipadala ang user sa hosted url nito. Doon, magko-connect sila ng WhatsApp numero sa pamamagitan ng Embedded Signup ng Meta, o mag-sign in sa Instagram, Facebook, TikTok, YouTube, LinkedIn at iba pang channel, saka babalik sa inyong redirect_url kasama ang bagong koneksyon o channel id. Isang oras ang bisa ng mga link.
Gaano katagal gumagana ang connect link; pagkatapos nito, expired na ang session at kailangan ng bagong link.
Hanggang ilang connect session ang puwedeng bukas nang sabay sa isang account, at 100 bagong session lang kada oras.
Ginagawa, binubuksan, nakokonekta, kinakansela o nagiging expired ang isang session, ayon sa ulat ng GET /connect-sessions/:id.
Ang pinakamahabang alternate callback URL na tinatanggap ng Meta para i-route ang mga webhook ng mensahe ng isang WhatsApp numero sa ibang lugar.
Paano gumagana ang connect link?
Parang checkout page. Ipinapadala ng inyong backend ang session, ipinapadala ng inyong interface ang customer sa url nito, nagko-connect ang customer sa pahinang nasa easycoexistence.com, at bumabalik ang browser sa inyong redirect_url. Pagkatapos, kinukumpirma ng inyong backend ang resulta at kinukuha ang credentials ng bagong koneksyon, gamit ang inyong API key.
Ano ang nasa request?
Isang JSON body na ipinopost sa https://easycoexistence.com/api/v1/connect-sessions, na may inyong API key bilang Bearer token. Tanging redirect_url ang kailangan:
redirect_url: isang https URL kung saan dadapo ang customer pagkatapos.- channel: whatsapp, ang default, o isang social network na bukas sa inyong account, na nakasulat sa maliliit na letra, gaya ng instagram, tiktok o youtube.
external_ref: inyong sariling id para sa customer na ito, hanggang 200 karakter.partner_name: ang pangalang ipinapakita ng hosted page, hanggang 80 karakter; ang pangalan ng inyong account ang default.webhook_urlkasama angwebhook_verify_token: para sa numero lamang, at palaging magkasama. Dito ipapadala ng Meta ang mga mensahe ng numero mula mismong sandaling kumonekta ito.
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"
}'Ano ang ibinabalik?
Isang 201 kasama ang session. Ipadala ang customer sa url, at itago ang id, na nagsisimula sa cs_, para mahanap ang session pagkatapos. Ang expires_at ay isang oras pagkatapos ng paglikha, at lumalabas ang connection_id o channel_id kapag nakakonekta na ang customer, depende sa channel ng session. Ibinabalik ng GET /connect-sessions/:id ang parehong anyo anumang oras.
{
"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"
}Anong mga error ang maaaring ibalik ng paggawa ng session?
Pareho ang katawan ng bawat error, isang object na may code at mensahe, at sinasabi ng mensahe kung ano ang aayusin. Ang paggawa ng session ay maaaring magbalik ng:
- 400
invalid_jsonoinvalid_request: hindi JSON object ang body, o may field na pumalya sa validation, gaya ngredirect_urlna hindi https. - 400
channel_unavailable: hindi bukas sa account na ito ang channel; nakalista sa mensahe ang mga bukas. - 401 unauthorized: nawawala o mali ang API key.
- 402
billing_required: wala pang card ang account, at lahat ng nakakonekta sa pamamagitan nito ay sisingilin sa account na ito. - 429
cap_reached: may 50 session nang bukas; maghintay na matapos o mag-expire ang ilan. - 429
rate_limited: higit sa 100 session ngayong oras; sinasabi ng mensahe kung gaano katagal maghihintay.
Saan pupunta ang customer pagkatapos?
Sa inyong redirect_url, kasama ang kinalabasan sa query string nito. Ang parehong kinalabasan ay nasa session, na binabasa ng inyong backend gamit ang GET /connect-sessions/:id:
- session: ang session id, cs_ kasunod ng random na karakter.
- status: connected, o cancelled kapag pinili ng customer ang Cancel and go back.
external_ref: ang id ninyo para sa customer, kapag may dala itong session.connection_id: ang id ng bagong numero, para sa /connections.channel_id: ang id ng bagong social account, para sa /channels.
https://app.example.com/connect/return?session=cs_…&status=connected&external_ref=customer_4821&connection_id=…Anong mga status ang maaaring taglayin ng session?
Lima. Iniuulat ng GET /connect-sessions/:id ang kasalukuyan, kasama ang opened_at, finished_at at last_error, na nagpapaliwanag kung bakit pumalya ang huling pagsubok:
- created: ginawa ng inyong backend, hindi pa nabubuksan.
- opened: naibukas na ng customer ang hosted page.
- connected: nakakonekta na ang numero o social account, at nasa session ang id nito.
- cancelled: umalis ang customer sa pamamagitan ng Cancel and go back.
- expired: naubos ang isang oras bago natapos ang session.
Gaano katagal gumagana ang link?
Isang oras mula sa paglikha. Pagkatapos nito, sasabihin ng hosted page sa customer na expired na ang link, na may button pabalik sa inyong redirect_url na may markang status=cancelled, at lalabas na expired ang session. Ang isang account ay maaaring magkaroon ng 50 bukas na session at gumawa ng 100 kada oras, dahil binibilang ng Meta ang bawat unang onboarding laban sa limitasyon ng buong app na pinagsasaluhan ng lahat ng account.
Ano ang ginagawa ng external_ref?
Iniuugnay nito ang bawat koneksyon sa inyong customer. Ang value na ipinadala ninyo ay itinatago sa numero o channel na nalikha ng session, idinadagdag sa redirect, at kasama sa bawat status event tungkol dito, kaya nalilista ng GET /connections?external_ref=customer_4821 at GET /channels?external_ref=customer_4821 ang mga nakakonekta ng customer na iyon. Maaaring magdala ang sign-in sa Facebook o LinkedIn ng ilang Page nang sabay: pinangalanan ng redirect ang una, at inililista ng filter ang iba. Gamitin po ang matatag na id mula sa inyong sariling database, hindi email na maaaring magbago.
Ano ang mangyayari kapag nagkansela ang customer o pumalya ang sign-in?
Depende kung saan ito nangyari, at iniingatan ng session ang talaan:
- Nabigo o nasara ang popup ng Meta: pinipindot ng customer muli ang Connect sa parehong pahina habang bukas pa ang link.
- Kinansela o tinanggihan ang social sign-in: bumabalik ang customer sa hosted page kasama ang dahilan at puwedeng sumubok muli hanggang mag-expire ang link.
- Nakakonekta na ang account sa ibang easyCoexistence account: sinasabi ito ng
last_error, at mag-sign in ang customer gamit ang iba. - Pinili ng customer ang Cancel and go back: makakatanggap ang inyong
redirect_urlng status=cancelled at magsasara ang session, kaya gumawa ng bagong session para sa ibang pagsubok. - Nag-expire ang link: gumawa ng bagong session.
Ano ang mangyayari kung kumonekta ang numero nang walang token ng customer?
Minsan tinatapos ng Meta ang Embedded Signup nang hindi nag-iisyu ng sariling token ng negosyo ng customer. Hinihiling ng hosted page ang isa pang ulit, na tumatagal ng ilang segundo. Kapag nilaktawan ito ng customer, lalabas na connected ang session na may token_ready false, at makakatanggap ang inyong events URL ng connection.token_missing: tumatanggap ng mensahe ang numero, dahil valid ang mga id nito, pero hindi ito makapagpapadala hanggang muling i-connect ito ng bagong connect session at mag-isyu ng token.
Ano ang mangyayari kung pumalya ang webhook_url sa pagsusuri ng Meta?
Kumokonekta pa rin ang numero. Sinusuri ng Meta ang webhook_url gamit ang GET handshake, na nalalampasan ng inyong endpoint sa pamamagitan ng pag-echo ng hub.challenge kapag tugma ang hub.verify_token. Kapag pumalya, magsisimula ang last_error ng session sa webhook_url was not applied at ibibigay ang dahilan ng Meta, at itinatakda ng PUT /connections/:id/webhook ang destinasyon kapag sumagot na ang endpoint. Kung maitatakda sa loob ng 24 na oras mula sa pagkakakonekta, makakatanggap pa rin ito ng isang beses na import ng mga contact at, kung pumayag ang customer na ibahagi ito, ng chat history.
Ano ang nakikita ng customer?
Isang pahina sa easycoexistence.com na may inyong pangalan mula sa partner_name, at walang account, email o card na pupunan. Para sa numero ng WhatsApp, may maikling checklist ng pagiging eligible, saka ang popup ng Meta at QR code na ii-scan gamit ang WhatsApp Business app. Para sa social account, isang button lamang ang nakikita, gaya ng Continue with TikTok, na nagbubukas ng sariling consent screen ng network sa parehong tab, kaya gumagana rin ito sa mga telepono.
Mga karaniwang pagkakamali
- Pagtitiwala sa query string lang. Kahit sino ay maaaring mag-type ng status=connected sa URL, kaya kumpirmahin gamit ang GET /connect-sessions/:id mula sa inyong backend bago markahan ang customer na connected.
- Pag-embed ng link sa iframe. Ipadala ang customer dito sa pamamagitan ng redirect o bagong tab, dahil ganito dapat tumakbo ang hosted page at ang mga sign-in na binubuksan nito.
- Paggawa ng link nang maaga. Gumagana ang bawat isa nang isang oras, at bawat bukas ay binibilang sa limitasyong 50, kaya gumawa ng session kapag malapit nang kumonekta ang customer.
- Pagpapadala ng webhook_url na mahigit 200 karakter. Tumatanggap ang Meta ng alternate callback URL na hanggang 200 karakter, kaya hindi ito ilalapat at kokonekta ang numero nang wala ito.
Pinagko-connect ng easyCoexistence ang mga WhatsApp numero ng inyong customer at ang kanilang Instagram, Facebook, TikTok, YouTube at LinkedIn account, at iba pang channel, sa inyong software sa pamamagitan ng iisang hosted link. Pagkatapos, ibinibigay nito sa inyong backend ang credentials, webhook at naka-sign na status event ng bawat koneksyon. US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, na may unang 3 araw na free trial.
Mga madalas itanong
Puwede bang gamitin nang dalawang beses ang isang connect link?
Hindi. Natatapos ang link sa isang numero, o sa isang social sign-in, na sa Facebook o LinkedIn ay maaaring magdala ng ilang Page. Pagkatapos nito, lalabas na connected ito, kaya gumawa ng bagong session para sa susunod na koneksyon.
Puwede bang ipadala ang link sa email o chat?
Oo, basta mabuksan ito ng customer sa loob ng isang oras. Ang session id sa URL ang nagbibigay ng awtorisasyon sa pahina, kaya ipadala lamang ang bawat link sa customer na pinaggawan nito.
Gumagana ba ang hosted page sa mga telepono?
Gumagana para sa social sign-in, dahil nagbubukas ang mga ito sa parehong tab. Pinakamainam na i-connect ang numero ng WhatsApp mula sa computer: sa telepono, nagbubukas ang popup ng Meta bilang bagong tab, at kailangan pa rin ng telepono para i-scan ang QR code.
Paano malalaman na may customer na nakakonekta nang hindi nagpo-poll?
Magtakda ng status events URL sa dashboard sa ilalim ng Profile, Developers. Pagkatapos, ipo-post ng easyCoexistence ang connection.connected o channel.connected, naka-sign at dala ang inyong external_ref, sa sandaling mabuo ang koneksyon.
Magpatuloy sa pagbabasa
I-connect ang inyong unang channel sa loob ng dalawang minuto.
Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.
- 3 araw na libre
- Mag-cancel anumang oras
- Official API lang
- Minomonitor 24/7
Na-verify noong