Webhooks en la API de FoodSoul: el CRM informa automáticamente a sus servicios sobre nuevos eventos
Ahora FoodSoul envía notificaciones automáticamente a tus sistemas cuando ocurre algo en el CRM. Por ejemplo, llega un nuevo pedido, un cliente paga o recibe un reembolso, o se registra un nuevo invitado. Solo necesitas indicar una vez la dirección de tu servicio, y los datos se enviarán de inmediato a tu sistema contable, tu bot, un segundo CRM o a la analítica.
Sobre qué eventos puedes recibir notificaciones
- Nuevo pedido con ficha completa. Útil para el sistema contable, la cocina y la analítica.
- Cambio de estado del pedido. Adecuado para un bot que informa al cliente sobre el pedido y para el call center.
- Cambio de estado del pago, incluyendo reembolsos. Necesario para contabilidad y control financiero.
- Nuevo cliente y modificación de sus datos. Para CRM externos y servicios de mailing.
- Acreditación, deducción y expiración de bonos. Para el programa de fidelidad y la comunicación con los invitados.
- Nueva reseña. Para el gerente y el departamento de calidad.
- Asignación de repartidor. Para logística y notificaciones al cliente.
- Modificación de la lista de productos no disponibles. Para el sitio web, la cocina y las plataformas donde vendes.
- La sucursal detuvo o reanudó la recepción de pedidos. Para el control operativo y la dirección de la cadena.
Tú eliges qué eventos recibir. Puedes activar solo los necesarios, por ejemplo “nuevo pedido” y “pago”. ¿No encuentras el evento que necesitas? Escríbenos — con gusto lo añadiremos.
Cómo conectar
- Activa los webhooks para la sucursal deseada — la clave de firma se generará automáticamente.
- Elige los eventos sobre los que deseas recibir notificaciones.
- Indica la dirección de tu servicio a la que FoodSoul enviará los datos. Solo se acepta una dirección con HTTPS.
- Agrega la clave de firma al servicio que recibe las notificaciones y configura la verificación de la firma. Si al crear los webhooks indicaste diferentes direcciones, añade la clave en cada servicio.
- Asegúrate de que el servicio confirme la recepción de la notificación en un plazo de 10 segundos, de lo contrario FoodSoul la reenviará.
Configura la verificación de duplicados: una misma notificación puede llegar varias veces. Todos los duplicados tienen el mismo ID (cabecera X-Webhook-ID). Haz que tu servicio recuerde los ID de las notificaciones procesadas y omita los duplicados — así un pago no se procesará dos veces.
Seguridad: para qué sirve la clave de firma
FoodSoul firma cada notificación con una clave de firma — un conjunto de caracteres que solo tú y nosotros conocemos. Con esta firma, tu sistema verifica que la notificación proviene de FoodSoul y que nadie la ha modificado en el camino.
Cualquiera puede enviar una solicitud a la dirección de tu servicio. Por ejemplo, un estafador podría enviar una notificación falsa de “pedido pagado” y tú entregarías un pedido no pagado.
Con la firma, esto no ocurrirá. Tu servidor calcula la firma con la misma clave y la compara con la recibida. Si las firmas no coinciden, significa que la notificación es falsa o ha sido modificada.
Si algo sale mal
- Si tu servicio está temporalmente fuera de línea, FoodSoul intentará varias veces entregar la notificación durante 10 horas. Un fallo breve o el reinicio del servidor no provocarán la pérdida de eventos.
- Si el problema persiste, la suscripción se desactivará y recibirás un correo: así sabrás del inconveniente.
- Para volver a activar la suscripción, escribe al soporte técnico. Allí también puedes reenviar las notificaciones que no llegaron durante la interrupción.
La descripción detallada de los eventos y el formato de los datos está en la documentación de la API.
¡Atentamente, el equipo de FoodSoul! ¡Trabajamos para ti!