Prijavite seZapočnite besplatni probni period
easyCoexistence Zvanični API-ji

Kako da vaši korisnici povežu WhatsApp, Instagram i TikTok naloge sa vašom aplikacijom

Da biste omogućili korisnicima da povežu WhatsApp, Instagram i TikTok naloge sa vašom aplikacijom, napravite sesiju za povezivanje preko Partner API-ja easyCoexistence i pošaljite korisnika na njen hostovani URL. Tamo povezuju WhatsApp broj preko toka Embedded Signup ili se prijavljuju na Instagram, Facebook, TikTok, YouTube, LinkedIn i još kanala, a zatim se vraćaju na vaš redirect_url sa novom vezom ili ID-jem kanala. Linkovi važe jedan sat.

1 hour

Koliko dugo važi link za povezivanje; posle toga sesija dobija status expired i potreban je novi link.

50 open

Koliko sesija za povezivanje jedan nalog može istovremeno da drži otvorenim, uz ograničenje od 100 novih sesija na sat.

5 statuses

Sesija može biti created, opened, connected, cancelled ili expired, kako to prikazuje GET /connect-sessions/:id.

200 characters

Najduži alternativni callback URL koji Meta prihvata za preusmeravanje webhook poruka WhatsApp broja na drugu adresu.

Kako radi link za povezivanje?

Kao stranica za plaćanje. Vaš backend kreira sesiju, vaš interfejs šalje korisnika na njen URL, korisnik se povezuje na stranici na easycoexistence.com, a pregledač se vraća na vaš redirect_url. Zatim vaš backend potvrđuje rezultat i preuzima kredencijale nove veze, sve uz vaš API ključ.

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

Šta ide u zahtev?

JSON telo poslato na https://easycoexistence.com/api/v1/connect-sessions, uz vaš API ključ kao Bearer token. Obavezno je samo redirect_url:

  • redirect_url: https URL na koji korisnik stiže nakon toga.
  • channel: whatsapp, podrazumevano, ili društvena mreža otvorena za vaš nalog, po imenu malim slovima, na primer instagram, tiktok ili youtube.
  • external_ref: vaš sopstveni ID za ovog korisnika, do 200 znakova.
  • partner_name: ime koje prikazuje hostovana stranica, do 80 znakova; podrazumevano je ime vašeg naloga.
  • webhook_url uz webhook_verify_token: samo za brojeve i uvek zajedno. Meta tamo isporučuje poruke broja od trenutka povezivanja.
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"
  }'

Šta se vraća?

201 sa sesijom. Pošaljite korisnika na url, a zadržite id, koji počinje sa cs_, da kasnije pronađete sesiju. expires_at ističe jedan sat posle kreiranja, a connection_id ili channel_id se popunjava kada se korisnik poveže, zavisno od kanala sesije. GET /connect-sessions/:id u bilo kom trenutku vraća isti oblik.

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"
}

Koje greške može da vrati kreiranje sesije?

Svaka greška ima isto telo, objekat sa kodom i porukom, a poruka kaže šta treba popraviti. Kreiranje sesije može da vrati:

  • 400 invalid_json ili invalid_request: telo nije JSON objekat ili polje nije prošlo proveru, na primer redirect_url koji nije https.
  • 400 channel_unavailable: kanal nije otvoren za ovaj nalog; poruka navodi one koji jesu.
  • 401 unauthorized: API ključ nedostaje ili nije ispravan.
  • 402 billing_required: nalog još nema karticu, a sve što je povezano preko njega naplaćuje se na nju.
  • 429 cap_reached: već je otvoreno 50 sesija; sačekajte da se neke završe ili isteknu.
  • 429 rate_limited: više od 100 sesija u ovom satu; poruka kaže koliko treba čekati.

Gde korisnik završi posle toga?

Na vašem redirect_url, uz ishod dodat u query string. Isti ishod je u sesiji, koju vaš backend čita sa GET /connect-sessions/:id:

  • session: ID sesije, cs_ praćen slučajnim znakovima.
  • status: connected, ili cancelled kada je korisnik izabrao „Otkaži i vrati se“.
  • external_ref: vaš ID za korisnika, kada ga je sesija imala.
  • connection_id: ID novog broja, za /connections.
  • channel_id: ID novog naloga na društvenoj mreži, za /channels.
A number connected
https://app.example.com/connect/return?session=cs_…&status=connected&external_ref=customer_4821&connection_id=…

Koje statuse sesija može imati?

Pet. GET /connect-sessions/:id prikazuje trenutni, uz opened_at, finished_at i last_error, koji kaže zašto je poslednji pokušaj propao:

  • created: napravio ga je vaš backend, još nije otvoren.
  • opened: korisnik je učitao hostovanu stranicu.
  • connected: broj ili društveni nalog je povezan, a njegov ID je u sesiji.
  • cancelled: korisnik je otišao preko dugmeta „Otkaži i vrati se“.
  • expired: sat je istekao pre nego što je sesija završena.

Koliko dugo link važi?

Jedan sat od kreiranja. Posle toga hostovana stranica korisniku kaže da je link istekao, uz dugme za povratak na vaš redirect_url sa oznakom status=cancelled, a sesija dobija status expired. Nalog može da drži 50 otvorenih sesija i da kreira 100 na sat, jer Meta svako prvo uvođenje broji u ograničenje na nivou aplikacije koje dele svi nalozi.

Šta radi external_ref?

Povezuje svaku vezu sa vašim korisnikom. Vrednost koju pošaljete čuva se na broju ili kanalu koji sesija napravi, dodaje se u preusmeravanje i ulazi u svaki događaj o statusu, pa GET /connections?external_ref=customer_4821 i GET /channels?external_ref=customer_4821 prikazuju šta je taj korisnik povezao. Prijava preko Facebook-a ili LinkedIn-a može da donese nekoliko stranica odjednom: preusmeravanje navodi prvu, a filter prikazuje ostale. Koristite stabilan ID iz vaše baze, a ne e-poštu koja se može promeniti.

Šta ako korisnik otkaže ili prijava ne uspe?

Zavisi gde se dogodilo, a sesija čuva zapis:

  • Meta-in iskačući prozor ne uspe ili se zatvori: korisnik ponovo pritisne dugme Connect na istoj stranici dok je link otvoren.
  • Prijava na društvenu mrežu se otkaže ili odbije: korisnik se vraća na hostovanu stranicu sa razlogom i može ponovo da pokuša dok link ne istekne.
  • Nalog je već povezan preko drugog easyCoexistence naloga: last_error to kaže, a korisnik se prijavljuje sa drugim.
  • Korisnik izabere „Otkaži i vrati se“: vaš redirect_url dobija status=cancelled i sesija se zatvara, pa za novi pokušaj napravite novu sesiju.
  • Link je istekao: napravite novu sesiju.

Šta ako se broj poveže bez korisnikovog tokena?

Meta ponekad završi Embedded Signup bez izdavanja korisnikovog sopstvenog poslovnog tokena. Hostovana stranica tada traži još jedno izvršavanje, koje traje nekoliko sekundi. Ako korisnik to preskoči, sesija prikazuje connected sa token_ready false, a vaš URL za događaje dobija connection.token_missing: broj prima poruke, jer su njegovi ID-jevi ispravni, ali ne može da šalje dok ga nova sesija za povezivanje ne ponovo poveže i ne izda token.

Šta ako webhook_url ne prođe Meta-inu proveru?

Broj se ipak povezuje. Meta proverava webhook_url GET rukovanjem, koje vaš endpoint prolazi tako što vraća hub.challenge kada se hub.verify_token poklapa. Ako ne prođe, last_error na sesiji počinje sa „webhook_url was not applied“ i navodi Meta-in razlog, a PUT /connections/:id/webhook postavlja odredište kada endpoint odgovori. Ako se postavi u roku od 24 sata od povezivanja, i dalje prima jednokratni uvoz kontakata i, ako je korisnik pristao da ga podeli, istoriju čata.

Šta korisnik vidi?

Stranicu na easycoexistence.com sa vašim imenom iz partner_name, bez naloga, e-pošte ili kartice za popunjavanje. Za WhatsApp broj prikazuje kratku listu provere ispunjenosti uslova, zatim Meta-in iskačući prozor i QR kod za skeniranje aplikacijom WhatsApp Business. Za društveni nalog prikazuje jedno dugme, npr. „Nastavi sa TikTok“, koje u istom tabu otvara saglasnost mreže, pa radi i na telefonu.

Česte greške

  • Oslanjanje samo na query string. Svako može da upiše status=connected u URL, zato potvrdite sa GET /connect-sessions/:id sa vašeg backenda pre nego što korisnika označite kao povezanog.
  • Ugrađivanje linka u iframe. Pošaljite korisnika preko preusmeravanja ili novog taba, jer tako treba da rade hostovana stranica i prijave koje otvara.
  • Pravljenje linkova unapred. Svaki važi jedan sat i svaki otvoren se računa u limit od 50, zato sesiju napravite kada je korisnik spreman da se poveže.
  • Slanje webhook_url duže od 200 znakova. Meta prihvata alternativne callback URL-ove do 200 znakova, pa se duži ne primenjuje i broj se povezuje bez njega.
Ovo radite uz EasyCoexistence

easyCoexistence povezuje WhatsApp brojeve vaših korisnika i njihove naloge na Instagram, Facebook, TikTok, YouTube i LinkedIn, kao i još kanala, sa vašim softverom preko jednog hostovanog linka, a zatim vašem backendu daje kredencijale svake veze, webhookove i potpisane događaje o statusu. US$ 9 do US$ 0.75 po vezi mesečno, sa smanjenjem kako dodajete veze, uz prva 3 dana besplatno.

Često postavljana pitanja

Može li se jedan link za povezivanje koristiti dva puta?

Ne. Link se završava jednim brojem ili jednom prijavom na društvenu mrežu, koja na Facebook-u ili LinkedIn-u može da donese nekoliko stranica. Posle toga dobija status connected, zato za sledeću vezu napravite novu sesiju.

Mogu li link da pošaljem e-poštom ili na čet?

Da, dok korisnik ne otvori link u roku od sat vremena. ID sesije u URL-u je ono što autorizuje stranicu, zato svaki link šaljite samo korisniku za kojeg je napravljen.

Da li hostovana stranica radi na telefonima?

Prijave na društvene mreže rade, jer se otvaraju u istom tabu. Broj na WhatsApp-u najbolje je povezati sa računara: na telefonu se Meta-in iskačući prozor otvara kao novi tab, a za skeniranje QR koda potreban je upravo taj telefon.

Kako saznati da se korisnik povezao bez proveravanja?

Postavite URL za događaje o statusu u kontrolnoj tabli pod Profile, Developers. easyCoexistence tada šalje connection.connected ili channel.connected, potpisane i sa vašim external_ref, čim se veza napravi.

Nastavite sa čitanjem

Povežite prvi kanal za dva minuta.

Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo zvanični API-ji
  • Nadzor 24/7

Provereno na