Este artículo explica cómo configurar Webhooks con la API de Gelato para recibir notificaciones en tu aplicación cuando ocurra algún evento relacionado con tu pedido.
Configuración de Webhook
La API de Gelato ofrece una sólida funcionalidad de Webhook que te permite estar al tanto de eventos críticos relacionados con tus pedidos. Para configurar tus webhooks, sigue estos pasos:
Accede al Panel de Gelato y ve a la sección de Webhooks. Esta área específica ofrece un centro centralizado para gestionar tus configuraciones de Webhook.
Haz clic en el botón "Add Webhook" para iniciar la creación de un nuevo Webhook. Esta acción te mostrará un formulario de configuración donde podrás especificar los detalles de tu Webhook.
Indica la URL del endpoint en tu aplicación que recibirá las notificaciones del Webhook. Asegúrate de que esta URL sea accesible públicamente y esté correctamente configurada para gestionar solicitudes HTTP entrantes. Selecciona el método HTTP, GET o POST, según las necesidades de tu aplicación. Elige los tipos de eventos a los que te quieres suscribir. Gelato ofrece una lista completa de tipos de eventos, como creación de pedidos, actualizaciones de pedidos y notificaciones de envío, para darte un control detallado sobre las notificaciones que recibes. Para descripciones detalladas de cada tipo de evento, consulta la documentación de la API.
Configura la autorización de tu Webhook para reforzar la seguridad y asegurarte de que las notificaciones provienen de una fuente de confianza. Elige el tipo de autorización adecuado, como encabezados HTTP o parámetros de consulta. Indica las credenciales necesarias, como una clave de API o un token, en los campos correspondientes. Para confirmar la configuración de tu Webhook y garantizar que las notificaciones se entregan correctamente, envía una notificación de prueba al endpoint especificado. Este paso ayuda a detectar y resolver posibles incidencias antes de implementar el Webhook en un entorno de producción.
Gestionar Webhooks
Una vez que hayas configurado tus webhooks, podrás gestionarlos fácilmente desde el Panel de Gelato. La sección Webhooks ofrece una vista completa de todos tus webhooks y te permite realizar acciones como:
Edición de webhooks existentes: Modifica la configuración de tus Webhooks en cualquier momento para adaptarla a tus necesidades en evolución. Actualiza la URL de notificación, las suscripciones a eventos o los detalles de autorización según sea necesario.
Eliminar webhooks: elimina los webhooks que ya no necesites para mantener una configuración de webhooks limpia y ordenada. Al eliminar un webhook, dejarán de enviarse notificaciones al endpoint asociado.
Para comprender mejor la API de Gelato, incluida información detallada sobre eventos y cargas útiles de Webhook, consulta nuestra completa documentación técnica.
Para acceder a la sección de Webhooks en tu cuenta de Gelato, puedes ir directamente a Desarrollador > Webooks desde el menú de la izquierda.