Conexiune și webhook-uri¶

Conversions API (fără token de acces), catalogul de produse, Lead Ads, paginile Facebook și Instagram și WhatsApp folosesc API-ul Meta. Acestea au nevoie de o conexiune Meta la contul care administrează activele dumneavoastră de afaceri și, pentru a primi notificări în timp real, de un webhook.

Conectarea Meta¶

Ca administrator, mergeți la Meta ‣ Configurare ‣ Conexiuni și creați o conexiune cu furnizorul Meta. Alegeți modul:
- Serviciu broker: nu trebuie creat nimic la Meta. Brokerul furnizorului dumneavoastră deține aplicația Meta. Vezi Broker de conexiune pentru Google și Meta.
- Credențialele propriei aplicații: creați o aplicație Meta și introduceți ID-ul și secretul acesteia, așa cum este explicat în Două moduri de conectare.
Faceți clic pe Conectează, autentificați-vă cu contul Facebook care administrează activele dumneavoastră de afaceri și acceptați permisiunile. Selectați toate activele (pagini, cataloage, conturi publicitare, conturi WhatsApp) pe care Odoo le poate folosi.
În Meta ‣ Configurare ‣ Setări, în blocul API Meta, selectați conexiunea în câmpul Conexiune Meta.

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.

O conexiune deservește toate funcțiile Meta: Odoo cere toate permisiunile deodată. Câmpul Versiune Graph API (doar pentru administratori) este versiunea API-ului Meta apelată de Odoo; păstrați valoarea implicită, cu excepția cazului în care un anunț Meta vă cere să o schimbați.

Important

Un token de acces Meta durează aproximativ 60 de zile. Când expiră, conexiunea trece în starea Eroare, iar funcțiile Meta se opresc (evenimentele rămân în coadă și sunt reîncercate). Deschideți conexiunea și faceți clic pe Reconectează.

Webhook-uri¶

Meta apelează baza dumneavoastră de date când se întâmplă ceva: o persoană completează un formular de lead, un client scrie pe Messenger, Instagram sau WhatsApp ori un mesaj este livrat. Odoo stochează notificarea și o procesează câteva minute mai târziu.

În blocul API Meta, activați Webhook-uri. Această setare se aplică întregii companii și este vizibilă doar administratorilor.
Copiați URL de callback webhook.
Introduceți ID aplicație Meta și Cheie secretă aplicație Meta ale aplicației dumneavoastră Meta. Secretul este folosit pentru a verifica dacă notificările provin într-adevăr de la Meta.
Faceți clic pe Generează token de verificare (sau tastați orice șir secret) și salvați.
În aplicația Meta, deschideți produsul Webhooks și, pentru fiecare obiect pe care îl folosiți (Page, Instagram, WhatsApp Business Account), introduceți URL-ul de apel invers și tokenul de verificare, apoi abonați-vă la câmpurile de care aveți nevoie (de exemplu leadgen pentru Lead Ads, messages pentru WhatsApp).

O aplicație Meta are un singur URL de apel invers pentru fiecare obiect. Notificările ajung, așadar, în baza de date a cărei adresă este înregistrată în aplicație. Dacă vă conectați printr-un broker, aplicația Meta aparține brokerului: funcțiile care necesită webhook-uri (Lead Ads, mesaje Facebook și Instagram, WhatsApp) necesită propria aplicație Meta, cu excepția cazului în care administratorul brokerului vă spune că notificările sunt redirecționate către baza dumneavoastră de date.

Notă

Odoo refuză o notificare a cărei semnătură nu corespunde secretului aplicației. Dacă aveți mai multe companii cu webhook-uri activate, fiecare companie trebuie să folosească propria aplicație Meta sau aceeași aplicație și același secret.

Linkul Notificări webhook deschide lista notificărilor primite (Meta ‣ Notificări webhook):

Stare	Semnificație
În așteptare	Se așteaptă următoarea procesare.
Procesată	Gestionat. Notificările procesate și ignorate sunt șterse după 30 de zile.
Ignorată	Un tip de notificare pe care nicio funcție a bazei dumneavoastră de date nu îl folosește.
Eroare	Încă eșuează după cinci încercări. Citiți eroarea, remediați cauza și faceți clic pe Procesează din nou.

Depanarea webhook-urilor¶

Meta refuză URL-ul de apel invers. Baza de date trebuie să fie accesibilă de pe Internet prin HTTPS, tokenul de verificare din Meta trebuie să fie identic cu cel din Odoo, iar Webhook-uri trebuie să fie activat.
Nu ajunge nimic. Verificați dacă aplicația Meta este în modul Live și dacă pagina sau contul WhatsApp este abonat la aplicație.
Notificări cu eroare. Deschideți una: fila Conținut afișează datele, iar eroarea arată motivul. Un contact lipsă sau o permisiune lipsă sunt cauzele obișnuite.
Notificările rămân în așteptare. Sunt procesate de o acțiune programată. Întrebați administratorul dacă este activă.

Vezi și