Conexión y webhooks¶

La Conversions API (sin un token de acceso), el catálogo de productos, Lead Ads, las páginas de Facebook e Instagram y WhatsApp usan la API de Meta. Necesitan una conexión de Meta a la cuenta que gestiona sus activos empresariales y, para recibir notificaciones en tiempo real, un webhook.

Conectar Meta¶

Como administrador, vaya a Meta ‣ Configuración ‣ Conexiones y cree una conexión con el proveedor Meta. Elija el modo:
- Servicio bróker: no hay nada que crear en Meta. El intermediario de su proveedor es el propietario de la aplicación de Meta. Vea Intermediario de conexión para Google y Meta.
- Credenciales de aplicación propias: cree una aplicación de Meta e introduzca su ID y su secreto, como se explica en Dos formas de conectar.
Haga clic en Conectar, inicie sesión con la cuenta de Facebook que gestiona sus activos empresariales y acepte los permisos. Seleccione todos los activos (páginas, catálogos, cuentas publicitarias, cuentas de WhatsApp) que Odoo puede usar.
En Meta ‣ Configuración ‣ Ajustes, en el bloque API de Meta, seleccione la conexión en el campo Conexión de 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.

Una conexión sirve para todas las funciones de Meta: Odoo pide todos los permisos a la vez. El campo Versión de la Graph API (solo administradores) es la versión de la API de Meta a la que llama Odoo; conserve el valor por defecto salvo que un anuncio de Meta le indique cambiarlo.

Importante

Un token de acceso de Meta dura unos 60 días. Cuando caduca, la conexión pasa a Error y las funciones de Meta se detienen (los eventos permanecen en la cola y se reintentan). Abra la conexión y haga clic en Volver a conectar.

Webhooks¶

Meta llama a su base de datos cuando ocurre algo: una persona rellena un formulario de oportunidades, un cliente escribe por Messenger, Instagram o WhatsApp, o se entrega un mensaje. Odoo guarda la notificación y la procesa unos minutos después.

En el bloque API de Meta, active Webhooks. Este ajuste se aplica a toda la empresa y solo lo ven los administradores.
Copie la URL de devolución de llamada del webhook.
Introduzca el ID de la aplicación de Meta y el Clave secreta de la aplicación de Meta de su aplicación de Meta. El secreto sirve para comprobar que las notificaciones proceden realmente de Meta.
Haga clic en Generar token de verificación (o escriba cualquier cadena secreta) y guarde.
En su aplicación de Meta, abra el producto Webhooks y, para cada objeto que use (Page, Instagram, WhatsApp Business Account), introduzca la URL de devolución de llamada y el token de verificación; después suscríbase a los campos que necesite (por ejemplo leadgen para Lead Ads, messages para WhatsApp).

Una aplicación de Meta tiene una única URL de devolución de llamada por objeto. Por tanto, las notificaciones llegan a la base de datos cuya dirección está registrada en la aplicación. Si se conecta a través de un intermediario, la aplicación de Meta pertenece al intermediario: las funciones que necesitan webhooks (Lead Ads, mensajes de Facebook e Instagram, WhatsApp) requieren su propia aplicación de Meta, salvo que el administrador del intermediario le indique que las notificaciones se reenvían a su base de datos.

Nota

Odoo rechaza una notificación cuya firma no coincide con el secreto de la aplicación. Si tiene varias empresas con webhooks activados, cada empresa debe usar su propia aplicación de Meta, o la misma aplicación y secreto.

El enlace Notificaciones de webhook abre la lista de las notificaciones recibidas (Meta ‣ Notificaciones de webhook):

Estado	Significado
Pendiente	A la espera del siguiente procesamiento.
Procesada	Gestionada. Las notificaciones procesadas e ignoradas se eliminan tras 30 días.
Ignorada	Un tipo de notificación que ninguna función de su base de datos utiliza.
Error	Sigue fallando tras cinco intentos. Lea el error, corrija la causa y haga clic en Volver a procesar.

Solución de problemas de webhooks¶

Meta rechaza la URL de devolución de llamada. La base de datos debe ser accesible desde Internet por HTTPS, el token de verificación en Meta debe ser idéntico al de Odoo y Webhooks debe estar activado.
No llega nada. Compruebe que su aplicación de Meta está en modo Live y que la página o la cuenta de WhatsApp está suscrita a la aplicación.
Notificaciones con error. Abra una: la pestaña Contenido muestra los datos y el error indica el motivo. Un contacto o un permiso que faltan son las causas habituales.
Las notificaciones siguen pendientes. Las procesa una acción programada. Pregunte a su administrador si está activa.

Ver también