Kapcsolat és webhookok¶

A Conversions API (hozzáférési token nélkül), a termékkatalógus, a Lead Ads, a Facebook- és Instagram-oldalak és a WhatsApp a Meta API-t használja. Szükségük van egy Meta-kapcsolatra az üzleti eszközeit kezelő fiókhoz, valamint az értesítések valós idejű fogadásához egy webhookra.

A Meta csatlakoztatása¶

Adminisztrátorként lépjen a Meta ‣ Konfiguráció ‣ Kapcsolatok menüpontra, és hozzon létre egy kapcsolatot a Meta szolgáltatóval. Válassza ki az üzemmódot:
- Bróker szolgáltatás: a Metánál nincs mit létrehozni. A Meta-alkalmazás a szolgáltatója közvetítőjéé. Lásd: Kapcsolatközvetítő a Google-höz és a Metához.
- Saját alkalmazás hitelesítő adatai: hozzon létre egy Meta-alkalmazást, és adja meg az azonosítóját és titkát, ahogyan a Két csatlakozási mód részben le van írva.
Kattintson a Csatlakozás gombra, jelentkezzen be az üzleti eszközeit kezelő Facebook-fiókkal, és fogadja el az engedélyeket. Válassza ki az összes eszközt (oldalakat, katalógusokat, hirdetési fiókokat, WhatsApp-fiókokat), amelyeket az Odoo használhat.
A Meta ‣ Konfiguráció ‣ Beállítások oldalon, a Meta API blokkban válassza ki a kapcsolatot a Meta-kapcsolat mezőben.

screenshot: meta-settings-connection

menu: Meta ‣ Configuration ‣ Settings
shows: The Meta API block of the Meta settings with the Meta Connection setting (Meta Connection and Graph API Version fields, Connections link) and the Webhooks setting enabled with the callback URL, the app ID, the app secret (hidden), the verify token, and the Generate Verify Token and Webhook Notifications links.
highlight: The Meta Connection field (red frame).
data: Connection "Meta - Main account".
notes: English UI, light theme, 1440px width, crop to the block.

Egy kapcsolat minden Meta-funkciót kiszolgál: az Odoo az összes engedélyt egyszerre kéri. A Graph API verzió mező (csak adminisztrátoroknak) az Odoo által hívott Meta API verziója; tartsa meg az alapértelmezett értéket, kivéve, ha egy Meta-közlemény a módosításra szólít fel.

Fontos

A Meta hozzáférési tokenje körülbelül 60 napig érvényes. Amikor lejár, a kapcsolat Hiba állapotba kerül, és a Meta-funkciók leállnak (az események a sorban maradnak, és újrapróbálódnak). Nyissa meg a kapcsolatot, és kattintson a Újracsatlakozás gombra.

Webhookok¶

A Meta hívja az adatbázisát, amikor valami történik: valaki kitölt egy leadűrlapot, egy ügyfél ír a Messengeren, az Instagramon vagy a WhatsAppon, vagy egy üzenet kézbesítésre kerül. Az Odoo eltárolja az értesítést, és néhány perccel később feldolgozza.

A Meta API blokkban engedélyezze a Webhookok beállítást. Ez a beállítás az egész vállalatra vonatkozik, és csak az adminisztrátorok számára látható.
Másolja ki a Webhook visszahívási URL értékét.
Adja meg a Meta-alkalmazás Meta alkalmazásazonosító és Meta alkalmazás titkos kulcsa értékét. A titok annak ellenőrzésére szolgál, hogy az értesítések valóban a Metától érkeznek.
Kattintson a Ellenőrző token generálása gombra (vagy írjon be bármilyen titkos karakterláncot), és mentse.
A Meta-alkalmazásban nyissa meg a Webhooks terméket, és minden használt objektumhoz (Page, Instagram, WhatsApp Business Account) adja meg a visszahívási URL-t és az ellenőrző tokent, majd iratkozzon fel a szükséges mezőkre (például leadgen a Lead Adshez, messages a WhatsApphoz).

Egy Meta-alkalmazásnak objektumonként egyetlen visszahívási URL-je van. Az értesítések ezért ahhoz az adatbázishoz érkeznek, amelynek a címe az alkalmazásban be van jegyezve. Ha közvetítőn keresztül csatlakozik, a Meta-alkalmazás a közvetítőé: a webhookokat igénylő funkciókhoz (Lead Ads, Facebook- és Instagram-üzenetek, WhatsApp) saját Meta-alkalmazásra van szükség, kivéve, ha a közvetítő adminisztrátora azt közli, hogy az értesítéseket továbbítják az Ön adatbázisához.

Megjegyzés

Az Odoo elutasítja azt az értesítést, amelynek az aláírása nem egyezik az alkalmazás titkával. Ha több vállalatnál is engedélyezve van a webhook, minden vállalatnak saját Meta-alkalmazást kell használnia, vagy ugyanazt az alkalmazást és titkot.

A Webhook-értesítések hivatkozás megnyitja a fogadott értesítések listáját (Meta ‣ Webhook-értesítések):

Állapot	Jelentés
Függőben	A következő feldolgozásra vár.
Feldolgozva	Kezelve. A feldolgozott és figyelmen kívül hagyott értesítések 30 nap után törlődnek.
Figyelmen kívül hagyva	Olyan értesítéstípus, amelyet az adatbázisa egyetlen funkciója sem használ.
Hiba	Öt próbálkozás után is hibás. Olvassa el a hibát, hárítsa el az okát, és kattintson a Újrafeldolgozás gombra.

Webhookok hibaelhárítása¶

A Meta elutasítja a visszahívási URL-t. Az adatbázisnak elérhetőnek kell lennie az internetről HTTPS-en, a Metában megadott ellenőrző tokennek meg kell egyeznie az Odoóban lévővel, és a Webhookok beállításnak engedélyezettnek kell lennie.
Semmi sem érkezik. Ellenőrizze, hogy a Meta-alkalmazása Live módban van-e, és hogy az oldal vagy a WhatsApp-fiók fel van-e iratkoztatva az alkalmazásra.
Hibás értesítések. Nyisson meg egyet: a Tartalom lapon láthatók az adatok, a hiba pedig megmondja az okot. A leggyakoribb ok egy hiányzó kapcsolat vagy egy hiányzó engedély.
Az értesítések függőben maradnak. Egy ütemezett művelet dolgozza fel őket. Kérdezze meg az adminisztrátorától, hogy aktív-e.

Lásd még