Kako omogućiti svojim korisnicima povezivanje računa WhatsApp, Instagram i TikTok s vašom aplikacijom
Da biste korisnicima omogućili povezivanje WhatsApp, Instagram i TikTok računa s vašom aplikacijom, stvorite sesiju povezivanja putem easyCoexistence Partner API-ja i pošaljite korisnika na njezin hostirani URL. Tamo povezuju WhatsApp broj putem postupka Embedded Signup tvrtke Meta ili se prijavljuju na Instagram, Facebook, TikTok, YouTube, LinkedIn i druge kanale, nakon čega se vraćaju na vaš redirect_url s novom vezom ili ID-om kanala. Poveznice vrijede sat vremena.
Koliko dugo poveznica za povezivanje vrijedi; nakon toga sesija ima status expired i potrebna je nova.
Broj sesija povezivanja koje jedan račun smije istodobno držati otvorenima, uz ograničenje od 100 novih sesija na sat.
Sesija može biti created, opened, connected, cancelled ili expired, što prikazuje GET /connect-sessions/:id.
Najdulji alternativni URL za povratni poziv koji Meta prihvaća za preusmjeravanje webhook poruka WhatsApp broja na drugo mjesto.
Kako funkcionira poveznica za povezivanje?
Slično stranici za plaćanje. Vaš backend stvara sesiju, vaše sučelje šalje kupca na njezin URL, kupac se povezuje na stranici na easycoexistence.com, a preglednik se vraća na vaš redirect_url. Vaš backend zatim potvrđuje rezultat i dohvaća vjerodajnice nove veze, sve s vašim API ključem.
Što ide u zahtjev?
JSON tijelo poslano na https://easycoexistence.com/api/v1/connect-sessions, s vašim API ključem kao Bearer tokenom. Obvezan je samo redirect_url:
redirect_url: https URL na koji kupac dolazi nakon toga.- channel: whatsapp, zadano, ili društvena mreža otvorena vašem računu, navedena malim slovima, primjerice instagram, tiktok ili youtube.
external_ref: vaš vlastiti ID za ovog kupca, do 200 znakova.partner_name: naziv koji prikazuje hostirana stranica, do 80 znakova; prema zadanim postavkama naziv vašeg računa.webhook_urluzwebhook_verify_token: samo za brojeve i uvijek zajedno. Meta tamo šalje poruke broja od trenutka povezivanja.
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"
}'Što se vraća?
Odgovor 201 sa sesijom. Pošaljite kupca na url, a id, koji počinje s cs_, sačuvajte za kasnije pretraživanje sesije. expires_at ističe sat vremena nakon stvaranja, a connection_id ili channel_id se popunjava kad se kupac poveže, ovisno o kanalu sesije. GET /connect-sessions/:id u bilo kojem trenutku vraća isti oblik.
{
"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"
}Koje pogreške može vratiti stvaranje sesije?
Svaka pogreška ima isto tijelo, objekt s kôdom i porukom, a poruka kaže što treba popraviti. Stvaranje sesije može vratiti:
- 400
invalid_jsoniliinvalid_request: tijelo nije JSON objekt ili polje nije prošlo provjeru, primjericeredirect_urlkoji nije https. - 400
channel_unavailable: kanal nije otvoren ovom računu; poruka navodi one koji jesu. - 401 unauthorized: API ključ nedostaje ili nije valjan.
- 402
billing_required: račun još nema karticu, a sve povezano putem njega naplaćuje se na nju. - 429
cap_reached: već je otvoreno 50 sesija; pričekajte da neke završe ili isteknu. - 429
rate_limited: više od 100 sesija u ovom satu; poruka kaže koliko dugo treba čekati.
Gdje kupac završava nakon toga?
Na vašem redirect_url, uz ishod dodan u query string. Isti ishod nalazi se u sesiji koju vaš backend čita pomoću GET /connect-sessions/:id:
- session: ID sesije, cs_ nakon kojeg slijede nasumični znakovi.
- status: connected, ili cancelled kad je kupac odabrao Odustani i vrati se.
external_ref: vaš ID za kupca, ako ga je sesija nosila.connection_id: ID novog broja, za /connections.channel_id: ID novog društvenog računa, za /channels.
https://app.example.com/connect/return?session=cs_…&status=connected&external_ref=customer_4821&connection_id=…Koje statuse sesija može imati?
Pet statusa. GET /connect-sessions/:id prikazuje trenutni, uz opened_at, finished_at i last_error, koji kaže zašto je posljednji pokušaj propao:
- created: stvorio ga je vaš backend, još nije otvoren.
- opened: kupac je učitao hostiranu stranicu.
- connected: broj ili društveni račun su povezani, a njegov ID je u sesiji.
- cancelled: kupac je otišao putem gumba Odustani i vrati se.
- expired: sat je istekao prije nego što je sesija završila.
Koliko dugo poveznica vrijedi?
Sat vremena od stvaranja. Nakon toga hostirana stranica obavještava kupca da je poveznica istekla, s gumbom za povratak na vaš redirect_url označenim status=cancelled, a sesija ima status expired. Račun može imati 50 otvorenih sesija i stvoriti 100 na sat, jer Meta svako prvo povezivanje broji prema ograničenju za cijelu aplikaciju koje dijele svi računi.
Čemu služi external_ref?
Veže svaku vezu uz vašeg kupca. Vrijednost koju pošaljete sprema se na broj ili kanal koji sesija stvori, dodaje se u preusmjeravanje i uključuje u svaki statusni događaj o njemu, pa GET /connections?external_ref=customer_4821 i GET /channels?external_ref=customer_4821 navode što je taj kupac povezao. Prijava putem Facebooka ili LinkedIna može donijeti nekoliko stranica odjednom: preusmjeravanje navodi prvu, a filtar navodi ostale. Koristite stabilan ID iz vlastite baze, a ne e-poštu koja se može promijeniti.
Što ako kupac odustane ili prijava ne uspije?
Ovisi o tome gdje se dogodilo, a sesija bilježi zapis:
- Metin skočni prozor ne uspije ili se zatvori: kupac ponovno pritisne Connect na istoj stranici dok je poveznica otvorena.
- Prijava na društvenu mrežu otkazana je ili odbijena: kupac se vraća na hostiranu stranicu s razlogom i može pokušati ponovno dok poveznica ne istekne.
- Račun je već povezan putem drugog easyCoexistence računa:
last_errorto navodi, a kupac se prijavljuje drugim. - Kupac odabere Odustani i vrati se: vaš
redirect_urldobiva status=cancelled, a sesija se zatvara, pa za novi pokušaj stvorite novu. - Poveznica je istekla: stvorite novu sesiju.
Što ako se broj poveže bez kupčevog tokena?
Meta ponekad dovrši Embedded Signup bez izdavanja kupčevog vlastitog poslovnog tokena. Hostirana stranica tada traži još jedno izvođenje, što traje nekoliko sekundi. Ako kupac to preskoči, sesija ima status connected s token_ready false, a vaš URL za događaje dobiva connection.token_missing: broj prima poruke jer su njegovi ID-ovi valjani, ali ne može slati dok nova sesija povezivanja ne ponovno poveže broj i izda token.
Što ako webhook_url ne prođe Metinu provjeru?
Broj se ipak povezuje. Meta provjerava webhook_url GET provjerom (handshake), koju vaš endpoint prolazi tako da vraća hub.challenge kad se hub.verify_token podudara. Ako ne prođe, last_error sesije počinje s webhook_url was not applied i navodi Metin razlog, a PUT /connections/:id/webhook postavlja odredište čim endpoint odgovori. Postavljen unutar 24 sata od povezivanja, i dalje prima jednokratni uvoz kontakata i, ako je kupac pristao na dijeljenje, povijest razgovora.
Što kupac vidi?
Stranicu na easycoexistence.com s vašim imenom iz partner_name i bez potrebe za računom, e-poštom ili karticom. Za WhatsApp broj prikazuje kratak popis za provjeru prikladnosti, zatim Metin skočni prozor i QR kôd za skeniranje aplikacijom WhatsApp Business. Za društveni račun prikazuje jedan gumb, primjerice Continue with TikTok, koji u istoj kartici otvara vlastiti zaslon za pristanak mreže, pa radi i na telefonima.
Uobičajene pogreške
- Oslanjanje samo na query string. Svatko može upisati status=connected u URL, pa prije nego što kupca označite kao povezanog potvrdite ga putem GET /connect-sessions/:id sa svog backenda.
- Ugrađivanje poveznice u iframe. Pošaljite kupca na nju preusmjeravanjem ili u novoj kartici, jer je tako namijenjeno da rade hostirana stranica i prijave koje otvara.
- Izrada poveznica unaprijed. Svaka vrijedi sat vremena i svaka otvorena broji se prema ograničenju od 50, pa sesiju stvorite kad se kupac sprema povezati.
- Slanje webhook_url dužeg od 200 znakova. Meta prihvaća alternativne URL-ove za povratni poziv do 200 znakova, pa dulji nije primijenjen i broj se povezuje bez njega.
easyCoexistence povezuje WhatsApp brojeve vaših kupaca te njihove Instagram, Facebook, TikTok, YouTube i LinkedIn račune, i više kanala, s vašim softverom putem jedne hostirane poveznice, a zatim vašem backendu daje vjerodajnice svake veze, webhookove i potpisane statusne događaje. Od US$ 9 do US$ 0,75 po vezi mjesečno, uz pad kako dodajete veze, s prvih 3 dana besplatno.
Često postavljana pitanja
Može li se jedna poveznica za povezivanje upotrijebiti dvaput?
Ne. Poveznica završava jednim brojem ili jednom prijavom na društvenu mrežu, koja na Facebooku ili LinkedInu može donijeti nekoliko stranica. Nakon toga ima status connected, pa za sljedeću vezu stvorite novu sesiju.
Mogu li poveznicu poslati e-poštom ili u chatu?
Da, pod uvjetom da je kupac otvori unutar sata. ID sesije u URL-u je ono što odobrava stranicu, pa svaku poveznicu šaljite samo kupcu za kojeg je napravljena.
Radi li hostirana stranica na telefonima?
Društvene prijave rade jer se otvaraju u istoj kartici. WhatsApp broj najbolje je povezati s računala: na telefonu se Metin skočni prozor otvara kao nova kartica, a za skeniranje QR kôda potreban je upravo telefon.
Kako doznati da se kupac povezao bez provjeravanja?
Postavite URL statusnih događaja na nadzornoj ploči pod Profile, Developers. easyCoexistence tada šalje connection.connected ili channel.connected, potpisane i s vašim external_ref, čim je veza uspostavljena.
Nastavite čitati
Povežite svoj prvi kanal u dvije minute.
Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo službeni API-ji
- Nadzor 24/7
Provjereno na