Ang account_update webhook at bawat dahilan ng disconnection
Ang account_update ang paraan ng Meta para iulat na nagbago ang estado ng isang koneksyon. Sinasabi ng event field kung ano ang nangyari, at para sa removal, sinasabi ng disconnection_info.reason kung bakit. Ang dahilan ang nagtatakda kung babalik pa ang numero o tuluyan na itong nawala.
Ang event na ipinapadala ng Meta kapag na-uninstall ang app mula sa isang account.
Mga tinukoy na dahilan ng disconnection na maaaring kasama sa removal.
Ang inactivity window ng primary device, na dumarating bilang PRIMARY_INACTIVITY.
Anong events ang dala ng account_update?
PARTNER_REMOVED, kapag na-uninstall ang app mula sa WhatsApp Business Account. Ito ang opisyal na signal ng disconnection at ang dapat pagbatayan, sa halip na hulaan ang disconnection dahil naging false ang isang field.
ACCOUNT_OFFBOARDED, kapag tuluyang na-offboard ang numero. ACCOUNT_RECONNECTED, kapag bumalik ang dating tinanggal na koneksyon. Kasama rin ang enforcement events: ACCOUNT_RESTRICTION at ACCOUNT_VIOLATION, pati ang mga event na may DISABLED o BAN sa pangalan.
Dito rin dumarating ang mga resulta ng verification at approval, na may VERIFIED o APPROVED sa pangalan ng event. Dapat mag-switch ang handler batay sa pangalan ng event at ituring na informational ang hindi nakikilalang event, sa halip na mag-fail, dahil maaaring magdagdag ang Meta ng events nang walang abiso.
Ano ang mga dahilan ng disconnection?
Anim ang mga ito, at magkakaiba ang ibig sabihin.
PRIMARY_INACTIVITY ang rule na humigit-kumulang labing-apat na araw: hindi binuksan ang WhatsApp Business app sa primary device. Nare-recover ito at pinakamadalas mangyari.
COMPANION_INACTIVITY ang parehong konsepto sa companion device, pero mas mahaba ang window, mga tatlumpung araw.
Ibig sabihin ng BUSINESS_DOWNGRADE ay bumalik ang numero sa consumer WhatsApp app. Tinatapos nito ang Coexistence dahil kailangan ng Coexistence ang Business app.
CHANGE_NUMBER kapag nagbago mismo ang phone number. USER_RE_REGISTERED kapag muling na-register ito sa bagong device. ACCOUNT_DISCONNECTED kapag sinadyang i-disconnect ito ng client o ng enforcement.
Dumarating din ang dahilan kasama ng disconnection_info.initiated_by, na nagsasabi kung tao o system ang gumawa nito.
Bakit mas mahalaga ang dahilan kaysa sa event?
Dahil hindi sapat ang PARTNER_REMOVED para malaman kung ano ang dapat gawin.
Kapag inalis ang numero dahil sa PRIMARY_INACTIVITY, babalik ito: bubuksan ng negosyo ang app, magre-reconnect, at magpapatuloy ang lahat. Kapag itinuring itong customer na umalis, makapagpapadala ng cancellation email sa taong customer pa rin.
Ibang sitwasyon ang numerong inalis dahil sa BUSINESS_DOWNGRADE o ACCOUNT_DISCONNECTED. Kapag itinuring itong pansamantala, maaaring manatiling naka-pending ang koneksyon nang walang katapusan.
Kapag walang kasamang dahilan ang removal, fallback ang initiated_by: ang removal na ginawa ng tao ay nagpapakitang sinadya ito, habang ang hindi maipaliwanag na removal ng system ay hindi ganoon. Mas mabuting ilagay ang pagkakaibang ito sa code kaysa ayusin pa ito sa support conversation.
Mga karaniwang pagkakamali
- Pare-parehong tinatrato ang bawat PARTNER_REMOVED. Ang dahilan ang naghihiwalay sa dalawang linggong katahimikan mula sa customer na umalis.
- Hinuhulaan ang disconnection dahil naging false ang isang field, sa halip na gamitin ang event na ito. Ito ang nagdudulot ng mga maling alert.
- Nagfa-fail kapag hindi nakikilala ang pangalan ng event. Nagdaragdag ang Meta ng events, kaya dapat laktawan ng handler ang hindi nito alam.
Hinahawakan ng EasyCoexistence ang bawat isa sa mga ito ayon sa pangalan, itinatala ang dahilan sa timeline ng koneksyon, at pinaghihiwalay ang nare-recover na inactivity removal mula sa numerong tuluyan nang nawala.
Mga madalas itanong
Permanent ba ang PARTNER_REMOVED?
Karaniwan, hindi. Karamihan ay may PRIMARY_INACTIVITY, ibig sabihin hindi binuksan ang app at maibabalik ang lahat kapag nag-reconnect.
Naibabalik ba ng reconnecting ang webhook destination?
Hindi, at ito ang madalas na bitag. Ang destination ay override sa app subscription at na-uninstall kasama nito. Kailangan itong i-reapply.
Ano ang COMPANION_INACTIVITY?
Parehong konsepto ng inactivity sa companion device sa halip na primary device, pero mas mahaba ang window na humigit-kumulang tatlumpung araw.
Makukuha ba ang event na ito nang walang dahilan?
Oo. Kapag nangyari ito, ang disconnection_info.initiated_by lang ang signal kung sinadya ang removal.
Magpatuloy sa pagbabasa
Handa na po ba kayong magsimula?
I-set up ang WhatsApp Coexistence sa loob ng ilang minuto, hindi buwan. Patuloy na gumagana ang app sa telepono.
Magsimula ng Libreng TrialNa-verify noong