Kako dodati WhatsApp u vaš SaaS pomoću Embedded Signup i Coexistence
SaaS dodaje WhatsApp tako što povezuje postojeći broj svakog korisnika preko toka Embedded Signup sa Coexistence, koji nudi Meta, pa broj i dalje radi u aplikaciji WhatsApp Business. Uz easyCoexistence Partner API, jedna sesija povezivanja po korisniku pokreće taj tok na hostovanoj stranici, Meta isporučuje poruke broja na vaš webhook_url, a vaš backend odgovara preko Cloud API-ja tokenom samog korisnika.
Fiksni protok broja koji se koristi i sa aplikacijom WhatsApp Business i sa Cloud API-jem.
Najstarija verzija aplikacije WhatsApp Business sa kojom broj korisnika može da se poveže preko Coexistence.
Koliko unazad seže istorija razgovora koju Meta može da podeli pri uvođenju; mora da se sinhronizuje u roku od 24 sata.
Prozor za korisničku službu WhatsApp-a posle poruke ili poziva korisnika; svaka nova poruka ga resetuje.
Datum kada je Meta ukinula Embedded Signup v2 i v3, a integracije su prebačene na v4.
Koji su delovi WhatsApp integracije?
Pet, a easyCoexistence preuzima prvi i poslednji. Vaš proizvod zadržava logiku razgovora, inbox i sve što vaš model ili osoblje vaših korisnika napiše, dok Meta prenosi poruke između broja i vašeg servera:
Šta Coexistence menja za vaše korisnike?
Zadržavaju broj i telefon. Aplikacija WhatsApp Business nastavlja da radi uz Cloud API, pa osoblje odgovara sa telefona, a vaš proizvod odgovara preko API-ja. Ono što pošalju iz aplikacije stiže na vaš webhook kao smb_message_echoes. Uz to idu tri ograničenja: broj šalje fiksnih 20 poruka u sekundi, samo API može da šalje šablone i Meta raskida vezu sa brojem kada telefon ostane neaktivan oko 14 dana.
Kako izgleda korak povezivanja u vašem proizvodu?
Dugme Connect WhatsApp koje iz vašeg backenda poziva POST /connect-sessions sa redirect_url, id-em vašeg korisnika kao external_ref i webhook_url sa webhook_verify_token, pa Meta od prvog minuta usmerava broj ka vama. Korisnik potvrđuje kratku listu na hostovanoj stranici, prolazi kroz Metin iskačući prozor, skenira QR kod aplikacijom WhatsApp Business i vraća se vama sa connection_id. Da li Embedded Signup pokrenuti iz sopstvene Tech Provider aplikacije, umesto toga, proverava se u vodiču za Embedded Signup.
Kako poruke stižu do vašeg backenda?
Od Meta, direktno na webhook_url, bez zaustavljanja u easyCoexistence i bez kopije. Polje messages nosi ono što korisnici šalju i status onoga što vi šaljete, a smb_message_echoes nosi ono što osoblje šalje iz aplikacije. Meta potpisuje svaku isporuku tajnom aplikacije easyCoexistence, koja se nikada ne deli, pa dugačak nasumični tajni niz u putanji URL-a služi za autentifikaciju. Dva broja u jednom WhatsApp Business nalogu dele odredište: rutirajte prema value.metadata.phone_number_id.
Kako vaš backend odgovara i šalje šablone?
Preko Meta Graph API-ja i tokena korisnika iz GET /connections/{id}?credentials=1, koji vraća i send_endpoint. Slobodan tekst se šalje u roku od 24 sata od poslednje poruke osobe; posle toga prolazi samo šablon koji je Meta odobrila:
- Odgovor: POST /<
PHONE_NUMBER_ID>/messages sa type text, unutar prozora. - Šablon: isti poziv sa type template, nazivom šablona i njegovim kodom jezika.
- Kreiranje šablona: POST /<
WABA_ID>/message_templates, zatim proverite status, jer rezultati pregleda ne stižu nawebhook_url. - Mediji: POST /<
PHONE_NUMBER_ID>/media za otpremanje; dolazni mediji stižu kao ID koji se preuzima istim tokenom.
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 da uveze postojeća ćaskanja korisnika?
Jednom, pri povezivanju. Kada je webhook_url postavljen na sesiji, easyCoexistence traži od Meta da pošalje kontakte broja i, ako korisnik pristane u aplikaciji, istoriju razgovora do 180 dana, koja stiže kao smb_app_state_sync i history webhook-ovi. Meta to dozvoljava samo u roku od 24 sata od povezivanja, pa endpoint treba da odgovara pre nego što link pođe. Vodič za istoriju razgovora objašnjava payload-ove.
Ko plaća Meti za poruke?
Vaš korisnik. Meta naplaćuje poruke koje vaš backend šalje preko API-ja na WhatsApp Business nalog samog korisnika, uz način plaćanja koji on sam dodaje, a firma bez njega ne može da šalje marketinške šablone. easyCoexistence naplaćuje vašem nalogu po povezanom broju i nikada ne naplaćuje poruke niti uvećava Metine cene.
Šta se dešava kada broj ispadne?
Vaš URL za događaje dobija connection.disconnected sa Metinim razlogom kada je poznat. PRIMARY_INACTIVITY je pravilo od 14 dana, a nova sesija povezivanja za tog korisnika vraća isti broj. connection.token_missing znači da je broj povezan bez tokena korisnika, pa prima poruke ali ne može da šalje dok ga nova sesija ne poveže ponovo.
Česte greške
- Slanje linka za povezivanje pre nego što vaš webhook endpoint odgovori. Uvoz istorije se pokreće jednom, u roku od 24 sata od povezivanja, a sadržaj poslat pre nego što vaš URL proradi se gubi.
- Odgovaranje slobodnim tekstom posle zatvaranja prozora. Kada prođe 24 sata od poslednje poruke osobe, prolazi samo odobreni šablon.
- Slanje kampanje sa jednog broja punom brzinom. Coexistence broj šalje 20 poruka u sekundi, pa slanja svakog broja stavite u red po toj brzini.
- Očekivanje da osoblje šalje šablone sa telefona. U Coexistence ih samo API šalje, pa slanje šablona stavite u vaš proizvod.
easyCoexistence dodaje WhatsApp u vaš SaaS preko Embedded Signup toka sa Coexistence na hostovanoj stranici koja prikazuje vaše ime: korisnici zadržavaju broj i aplikaciju WhatsApp Business, Meta isporučuje poruke vašem serveru, a događaji stižu do vas potpisani. Isti API povezuje Instagram, Facebook, TikTok, YouTube, LinkedIn i druge kanale. US$ 9 do US$ 0.75 po vezi mesečno, sa padom kako dodajete veze, uz prvih 3 dana besplatno.
Često postavljana pitanja
Može li korisnik da poveže broj koji je kod drugog WhatsApp API provajdera?
Ne, dok je broj tamo. Hostovana lista traži broj bez drugog API provajdera ili alata za automatizaciju, pa korisnik prvo odjavljuje broj kod tog provajdera.
Može li moj SaaS da šalje WhatsApp šablone za svoje korisnike?
Može, preko Cloud API-ja sa tokenom svakog korisnika: kreirajte šablon na WhatsApp Business nalogu korisnika, sačekajte Metin pregled, pa ga pošaljite.
Da li easyCoexistence čita poruke mojih korisnika?
Ne. Meta isporučuje poruke broja direktno na webhook_url koji postavite. Broj bez webhook_url-a ide na povratni poziv easyCoexistence, gde se poruke odbacuju bez čuvanja.
Koliko košta easyCoexistence po WhatsApp broju?
US$ 9 do US$ 0.75 po broju mesečno, prema opsegu ukupnih veza, uz prvih 3 dana besplatno. Naplate poruka od Meta idu na WhatsApp Business nalog svakog korisnika.
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