Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

Kako dodati WhatsApp svom SaaS-u pomoću Embedded Signup i Coexistence

SaaS dodaje WhatsApp tako da poveže postojeći broj svakog kupca putem postupka Embedded Signup uz Coexistence, pa broj i dalje radi u aplikaciji WhatsApp Business. S Partner API-jem za easyCoexistence jedna sesija povezivanja po kupcu pokreće taj tijek na hostiranoj stranici, Meta isporučuje poruke broja na vaš webhook_url, a vaš backend odgovara putem Cloud API-ja s tokenom samog kupca.

20 mps

Fiksni protok broja koji se koristi i s aplikacijom WhatsApp Business i s Cloud API-jem.

2.24.17

Najstarija verzija aplikacije WhatsApp Business s kojom se broj kupca može povezati putem Coexistence.

180 days

Koliko unatrag Meta može podijeliti povijest razgovora pri uvođenju; mora se sinkronizirati unutar 24 sata.

24 hours

Prozor korisničke podrške WhatsAppa nakon poruke ili poziva korisnika; svaka nova poruka ga resetira.

October 15, 2026

Datum kada je Meta ukinula Embedded Signup v2 i v3, a integracije su prebačene na v4.

Koji su dijelovi integracije s WhatsAppom?

Pet, a easyCoexistence preuzima prvi i posljednji. Vaš proizvod zadržava logiku razgovora, ulazni pretinac i sve što pišu vaš model ili zaposlenici vaših kupaca, dok Meta prenosi poruke između broja i vašeg poslužitelja:

1ConnectEmbedded Signup with Coexistence on a hosted page
2Routewebhook_url set on the number as it connects
3ReceiveMeta posts messages and echoes to your server
4ReplyCloud API calls with the customer's token
5WatchStatus events when the number drops or returns

Što Coexistence mijenja za vaše kupce?

Zadržavaju svoj broj i svoj telefon. Aplikacija WhatsApp Business nastavlja raditi uz Cloud API, pa zaposlenici odgovaraju s telefona, a vaš proizvod odgovara putem API-ja. Ono što pošalju iz aplikacije stiže na vaš webhook kao smb_message_echoes. Uz to dolaze tri ograničenja: broj šalje po fiksnih 20 poruka u sekundi, predloške može slati samo API i Meta odspaja broj kada telefon ostane neaktivan oko 14 dana.

Kako izgleda korak povezivanja u vašem proizvodu?

Gumb Connect WhatsApp koji s vašeg backenda poziva POST /connect-sessions s redirect_url, identifikatorom vašeg kupca kao external_ref i webhook_url s webhook_verify_token, pa Meta broj usmjerava na vas već od prve minute. Kupac na hostiranoj stranici potvrđuje kratku listu provjere, pokreće skočni prozor koji nudi Meta, skenira QR kôd aplikacijom WhatsApp Business i vraća se k vama s connection_id. Pokretanje Embedded Signup iz vlastite aplikacije Tech Provider umjesto ovoga obrađeno je u vodiču za Embedded Signup.

Kako poruke stižu do vašeg backenda?

Iz Mete, izravno na webhook_url, bez zaustavljanja kod easyCoexistencea i bez zadržane kopije. Polje messages nosi ono što kupci šalju i status onoga što vi šaljete, a smb_message_echoes nosi ono što zaposlenici šalju iz aplikacije. Meta svaku isporuku potpisuje tajnim ključem aplikacije easyCoexistence, koji se nikada ne dijeli, pa dugi nasumični tajni niz u putanji URL-a služi za autentikaciju. Dva broja unutar jednog WhatsApp Business računa dijele odredište: usmjeravajte prema value.metadata.phone_number_id.

Kako vaš backend odgovara i šalje predloške?

Putem Graph API-ja s tokenom kupca iz GET /connections/{id}?credentials=1, koji vraća i send_endpoint. Slobodan tekst odlazi unutar 24 sata od posljednje poruke te osobe; nakon toga samo predložak koji je odobrila Meta:

  • Odgovor: POST /<PHONE_NUMBER_ID>/messages s type text, u prozoru.
  • Predložak: isti poziv s type template, nazivom predloška i kodom jezika.
  • Izrada predloška: POST /<WABA_ID>/message_templates, zatim provjeravajte njegov status, jer rezultati pregleda ne stižu na vaš webhook_url.
  • Mediji: POST /<PHONE_NUMBER_ID>/media za učitavanje; dolazni mediji stižu kao ID koji se dohvaća istim tokenom.
Reply inside the customer service window
curl -X POST "$SEND_ENDPOINT" \
  -H "Authorization: Bearer $CUSTOMER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "5511987654321",
    "type": "text",
    "text": { "body": "Your table for 4 is booked for 8 pm." }
  }'

Može li vaš proizvod uvesti postojeće razgovore kupca?

Jednom, pri povezivanju. Ako je na sesiji postavljen webhook_url, easyCoexistence traži od Mete da pošalje kontakte broja i, ako kupac to odobri u aplikaciji, do 180 dana razgovora, koji stižu kao webhookovi smb_app_state_sync i history. Meta to dopušta samo unutar 24 sata od povezivanja, pa endpoint mora odgovarati prije nego što poveznica ode. Vodič o povijesti razgovora opisuje strukturu podataka.

Tko plaća Meti poruke?

Vaš kupac. Meta naplaćuje poruke koje vaš backend šalje putem API-ja na WhatsApp Business račun samog kupca, na način plaćanja koji sam dodaje, a tvrtka bez njega ne može slati marketinške predloške. easyCoexistence naplaćuje vašem računu po povezanom broju i nikada ne naplaćuje poruke niti dodaje marže na cijene Mete.

Što se događa kada broj ispadne?

Vaš URL za događaje prima connection.disconnected s razlogom koji navodi Meta, kada je poznat. PRIMARY_INACTIVITY je pravilo od 14 dana, a nova sesija povezivanja za tog kupca vraća isti broj. connection.token_missing znači da je broj povezan bez tokena kupca, pa prima poruke, ali ne može slati dok ga nova sesija ponovno ne poveže.

Uobičajene pogreške

  • Slanje poveznice za povezivanje prije nego što vaš webhook endpoint počne odgovarati. Uvoz povijesti izvodi se jednom, unutar 24 sata od povezivanja, a sadržaj poslan prije nego što vaš URL radi, izgubljen je.
  • Odgovaranje slobodnim tekstom nakon zatvaranja prozora. Kada prođe 24 sata od posljednje poruke te osobe, prolazi samo odobreni predložak.
  • Slanje kampanje s jednog broja punom brzinom. Coexistence broj šalje po 20 poruka u sekundi, pa slanje svakog broja stavite u red čekanja po toj brzini.
  • Očekivanje da zaposlenici šalju predloške s telefona. U načinu rada Coexistence predloške šalje samo API, pa slanje predložaka smjestite u vaš proizvod.
Radite ovo uz EasyCoexistence

easyCoexistence dodaje WhatsApp vašem SaaS-u putem postupka Embedded Signup i Coexistence na hostiranoj stranici koja prikazuje vaše ime: vaši kupci zadržavaju broj i aplikaciju WhatsApp Business, Meta isporučuje poruke vašem poslužitelju, a događaji stižu potpisani. Isti API povezuje Instagram, Facebook, TikTok, YouTube, LinkedIn i još kanala. US$ 9 do US$ 0,75 po vezi mjesečno, uz sniženje kako dodajete veze, s prva 3 dana besplatno.

Često postavljana pitanja

Može li kupac povezati broj koji je kod drugog pružatelja WhatsApp API-ja?

Dok je tamo, ne može. Hostirana lista provjere traži broj bez drugog pružatelja API-ja ili alata za automatizaciju, pa kupac ga prvo odspaja od tog pružatelja.

Može li moj SaaS slati WhatsApp predloške za svoje kupce?

Da, putem Cloud API-ja s tokenom svakog kupca: stvorite predložak na WhatsApp Business računu kupca, pričekajte da Meta odobri predložak, pa ga pošaljite.

Čita li easyCoexistence poruke mojih kupaca na WhatsAppu?

Ne. Meta isporučuje poruke broja izravno na webhook_url koji postavite. Ako broju nije postavljen webhook_url, poruke idu na povratni poziv easyCoexistencea, gdje se odbacuju bez pohrane.

Koliko košta easyCoexistence po WhatsApp broju?

US$ 9 do US$ 0,75 po broju mjesečno, ovisno o razredu vaših ukupnih veza, s prva 3 dana besplatno. Naplate poruka od Mete idu na WhatsApp Business račun svakog kupca.

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