Mag-log inMagsimula ng Libreng Trial
easyCoexistence Mga Official API

Paano idagdag ang WhatsApp sa inyong SaaS gamit ang Embedded Signup at Coexistence

Nagdaragdag ang SaaS ng WhatsApp sa pamamagitan ng pag-connect ng numero ng bawat customer sa pamamagitan ng Embedded Signup ng Meta na may Coexistence, para patuloy na gumana ang numero sa WhatsApp Business app. Gamit ang Partner API ng easyCoexistence, isang connect session kada customer ang nagpapatakbo ng prosesong ito sa hosted page, ipinapadala ng Meta ang mensahe ng numero sa inyong webhook_url, at sumasagot ang inyong backend sa pamamagitan ng Cloud API gamit ang sariling token ng customer.

20 mps

Nakapirmihang throughput ng numero na ginagamit sa WhatsApp Business app at sa Cloud API.

2.24.17

Ang pinakalumang bersyon ng WhatsApp Business app kung saan maaaring mag-connect ang numero ng customer sa pamamagitan ng Coexistence.

180 days

Hanggang kailan maaaring ibahagi ng Meta ang chat history sa onboarding; kailangang i-sync ito sa loob ng 24 hours.

24 hours

Ang customer service window ng WhatsApp pagkatapos ng mensahe o tawag ng user; nire-reset ito ng bawat bagong mensahe.

October 15, 2026

Ang petsa kung kailan inalis ng Meta ang suporta sa Embedded Signup v2 at v3, at inilipat ang mga integration sa v4.

Ano ang mga bahagi ng integration ng WhatsApp?

Lima ito, at ang una at ang huli ay ang inaasikaso ng easyCoexistence. Ang inyong produkto ang humahawak sa lohika ng usapan, sa inbox, at sa anumang isinusulat ng inyong modelo o ng staff ng inyong mga customer. Ang Meta naman ang nagdadala ng mga mensahe sa pagitan ng numero at ng inyong server:

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

Ano ang nababago ng Coexistence para sa mga customer?

Nananatili sa kanila ang kanilang numero at ang kanilang telepono. Patuloy na gumagana ang WhatsApp Business app kasabay ng Cloud API, kaya sumasagot ang staff sa telepono habang sumasagot ang inyong produkto sa pamamagitan ng API. Ang mga ipinapadala mula sa app ay umaabot sa inyong webhook bilang smb_message_echoes. Tatlong limitasyon ang kasama nito: nagpapadala ang numero sa nakapirmihang 20 mensahe kada segundo, tanging ang API lang ang makapagpapadala ng template, at dinidiskonekta ng Meta ang numero kapag hindi aktibo ang telepono nang humigit-kumulang 14 na araw.

Ano ang hitsura ng hakbang sa pagkonekta sa inyong produkto?

Isang Connect WhatsApp button na tumatawag sa POST /connect-sessions mula sa inyong backend, kasama ang redirect_url, ang id ng customer bilang external_ref, at ang webhook_url kasama ang webhook_verify_token, para maiugnay agad ng Meta ang numero sa inyo mula sa unang minuto. Kukumpirmahin ng customer ang maikling checklist sa hosted page, patatakbuhin ang popup ng Meta, i-scan ang QR code gamit ang WhatsApp Business app, at babalik sa inyo na may connection_id. Kung dapat patakbuhin ang Embedded Signup mula sa sarili ninyong Tech Provider app sa halip, tinitimbang ito sa gabay ng Embedded Signup.

Paano nakakarating ang mga mensahe sa inyong backend?

Mula sa Meta, diretso sa webhook_url, nang hindi dumadaan sa easyCoexistence at walang kopyang itinatabi. Ang field na messages ang nagdadala ng ipinadala ng mga customer at ng estado ng ipinadala ninyo, at ang smb_message_echoes naman ang nagdadala ng ipinadala ng staff mula sa app. Nilalagdaan ng Meta ang bawat paghahatid gamit ang app secret ng easyCoexistence, na hindi kailanman ibinabahagi, kaya sapat na ang mahabang random na secret sa URL path para mapatunayan ito. Ang dalawang numero sa iisang WhatsApp Business Account ay may iisang destinasyon: magruta batay sa value.metadata.phone_number_id.

Paano sumasagot ang inyong backend at nagpapadala ng template?

Gamit ang Graph API ng Meta at ang token ng customer mula sa GET /connections/{id}?credentials=1, na nagbabalik din ng send_endpoint. Ang free-form text ay naipapadala sa loob ng 24 hours mula sa huling mensahe ng tao; pagkatapos nito, tanging template na inaprubahan ng Meta lang ang makakarating:

  • Sagot: POST /<PHONE_NUMBER_ID>/messages na may type text, sa loob ng window.
  • Template: parehong tawag na may type template, pangalan ng template, at language code nito.
  • Gumawa ng template: POST /<WABA_ID>/message_templates, pagkatapos i-poll ang status nito, dahil hindi umaabot sa webhook_url ang resulta ng review.
  • Media: POST /<PHONE_NUMBER_ID>/media para mag-upload; ang papasok na media ay dumarating bilang ID na kukunin gamit ang parehong token.
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." }
  }'

Maaari bang i-import ng inyong produkto ang umiiral na chat ng customer?

Minsan lang, sa oras ng pagkonekta. Kapag may webhook_url na nakatakda sa session, hinihiling ng easyCoexistence sa Meta na ipadala ang mga contact ng numero at, kung sumang-ayon ang customer sa app, hanggang 180 araw na chat, na dumarating bilang smb_app_state_sync at history webhooks. Pinapayagan ito ng Meta sa loob lang ng 24 hours mula sa pagkonekta, kaya dapat sumasagot na ang endpoint bago ipadala ang link. Saklaw ng gabay sa chat history ang mga payload.

Sino ang nagbabayad sa Meta para sa mga mensahe?

Ang customer ninyo. Sisingilin ng Meta ang mga mensaheng ipinapadala ng inyong backend sa pamamagitan ng API sa sariling WhatsApp Business Account ng customer, gamit ang payment method na idinaragdag nila roon, at hindi makapagpapadala ng marketing template ang negosyong walang ganoon. Sinisingil ng easyCoexistence ang inyong account kada naka-connect na numero at hindi naniningil para sa mga mensahe o nagmamarkup sa presyo ng Meta.

Ano ang mangyayari kapag nadiskonekta ang numero?

Tatanggap ang inyong events URL ng connection.disconnected kasama ang dahilan ng Meta kapag alam ito. Ang PRIMARY_INACTIVITY ang 14 na araw na patakaran, at ibabalik ng bagong connect session para sa customer na iyon ang parehong numero. Ang connection.token_missing ay nangangahulugang nakonekta ang numero nang walang token ng customer, kaya nakakatanggap ito ng mensahe pero hindi makapagpapadala hanggang muling makonekta ito ng bagong session.

Mga karaniwang pagkakamali

  • Pagpapadala ng link sa pagkonekta bago sumagot ang inyong webhook endpoint. Minsan lang tumatakbo ang pag-import ng chat history, sa loob ng 24 hours mula sa pagkonekta, at mawawala ang nilalamang ipinadala bago gumana ang URL ninyo.
  • Pagsagot ng free-form text pagkatapos magsara ang window. Kapag lumipas na ang 24 hours mula sa huling mensahe ng tao, tanging inaprubahang template na lang ang makakarating.
  • Pagpapadala ng kampanya mula sa isang numero nang buong bilis. Ang Coexistence na numero ay nagpapadala sa 20 mensahe kada segundo, kaya ilagay sa pila ang pagpapadala ng bawat numero sa bilis na iyon.
  • Pag-aakalang magpapadala ng template ang staff mula sa telepono. Sa Coexistence, tanging API lang ang nakakapagpadala nito, kaya ilagay ang pagpapadala ng template sa inyong produkto.
Ginagawa ito gamit ang EasyCoexistence

Idinaragdag ng easyCoexistence ang WhatsApp sa inyong SaaS gamit ang Embedded Signup at Coexistence ng Meta sa hosted page na nagpapakita ng pangalan ninyo. Nananatili sa mga customer ang kanilang numero at ang WhatsApp Business app, at inihahatid ng Meta ang mga mensahe sa inyong server bilang naka-sign na event. Inaabot din ng parehong API ang Instagram, Facebook, TikTok, YouTube, LinkedIn at iba pang channel. Mula US$ 9 kada koneksyon kada buwan, bumababa hanggang US$ 0.75 habang dumarami ang koneksyon, at may free trial na 3 days.

Mga madalas itanong

Maaari bang i-connect ng customer ang numerong nasa ibang WhatsApp API provider?

Hindi, habang nandoon pa ito. Hinihingi ng hosted checklist ang numerong walang ibang API provider o automation tool, kaya dapat munang i-disconnect ng customer ito sa provider na iyon.

Maaari bang magpadala ng WhatsApp template ang SaaS ninyo para sa mga customer nito?

Oo, sa pamamagitan ng Cloud API gamit ang token ng bawat customer: gumawa ng template sa WhatsApp Business Account nila, hintayin ang review ng Meta, saka ito ipadala.

Binabasa ba ng easyCoexistence ang mga mensahe ng WhatsApp ng inyong mga customer?

Hindi. Direktang inihahatid ng Meta ang mga mensahe ng numero sa webhook_url na itinakda ninyo. Ang numerong walang webhook_url ay babalik sa callback ng easyCoexistence, kung saan itinatapon ang mga mensahe nang hindi sine-save.

Magkano ang presyo ng easyCoexistence kada numero ng WhatsApp?

Mula US$ 9 hanggang US$ 0.75 kada numero kada buwan, ayon sa banda ng kabuuang koneksyon ninyo, at may free trial na 3 days. Ang singil ng Meta sa mga mensahe ay napupunta sa sariling WhatsApp Business Account ng bawat customer.

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