# Obtén un webhook cada vez que recibas un pedido de entradas | Guías de Ticket Fairy 1. [Ticket Fairy](https://www.ticketfairy.com/) 2. [Guías](https://www.ticketfairy.com/es/guides) 3. Obtén un webhook cada vez que recibas un pedido de entradas Desarrolladores y la API # Obtén un webhook cada vez que recibas un pedido de entradas Un webhook envía cada pedido a una dirección que controlas, unos segundos después de que el comprador pague. Las agencias y los promotores que tienen su propio CRM, sistema de almacén o sistema de gestión de pedidos reciben cada venta en cuanto ocurre, en lugar de esperar a una exportación nocturna. Haz que Ticket Fairy envíe cada pedido nuevo a una dirección que controlas, unos segundos después del pago, para que tus sistemas reciban la venta automáticamente. Para: Enviar cada venta de entradas a tus sistemas en cuanto ocurre Dura: 8 minutos - [Genera la clave del webhook](#step-1) - [Dirige un webhook a tu propia dirección](#step-2) - [Elige qué lo activa](#step-3) - [Cuándo poner un webhook en la marca en lugar de en el evento](#step-4) - [Asócialo donde deba escuchar](#step-5) - [Vende una entrada y comprueba que llega](#step-6) ## Antes de empezar - Tienes una dirección que responde a una solicitud POST y devuelve una respuesta rápidamente. Usa HTTPS para un endpoint real, porque cada solicitud incluye datos del pedido y del comprador. - Tienes un token de acceso personal para la línea de comandos. Crear uno tiene su propia guía. - Sabes qué eventos deben alimentarlo: un evento, todo lo que pertenece a una marca o todo lo que forma parte de una gira. 1. ## Genera la clave del webhook Abre la configuración de tu cuenta y selecciona **Generar clave de API de webhook** en **Clave de API de webhook**. **Nota:** Plataformas como Zapier te piden esta clave cuando las conectas. Un webhook que crees tú mismo llama directamente a tu dirección y no necesita nada de esta tarjeta. ![Tarjeta de clave de API de webhook de Ticket Fairy que muestra la clave y los controles para copiarla y regenerarla](https://www.ticketfairy.com/embeds/posters/marketing-developer-access--api-keys.png) La clave del webhook, una vez generada. 2. ## Dirige un webhook a tu propia dirección Ejecuta "ticketfairy webhook create --url https://example.com/hooks/tickets --on order" para la marca en la que estás trabajando. **Nota:** Cada pedido se envía a esa dirección como JSON. Responde rápidamente con un código de éxito y haz después el trabajo lento, para que una venta con mucha demanda no tenga que esperarte. 3. ## Elige qué lo activa Indica en "--on" el único elemento sobre el que quieres recibir avisos: "order" para los pedidos, o "new\_event", "update\_event", "publish\_event" y "find\_event" para el propio evento. **Nota:** Cada webhook envía un aviso, así que un sistema que quiera recibir pedidos y publicaciones necesita dos. ## Cuándo poner un webhook en la marca en lugar de en el evento Asocia un webhook a un evento cuando solo ese evento deba alimentar tu sistema, y a la marca cuando deban hacerlo todos los eventos. Una gira completa tiene su propia asociación. Las cuatro notificaciones de eventos son la excepción que lo decide por ti: "new\_event", "update\_event", "publish\_event" y "find\_event" solo llegan a los webhooks de la marca y de la gira, nunca a uno asociado a un único evento. Por eso, si un sistema quiere recibir avisos sobre publicaciones, su webhook debe estar en la marca. 4. ## Asócialo donde deba escuchar Indica "--event", "--brand" o "--tour" en el comando que lo crea. **Nota:** Si no indicas ninguno de los tres, el comando usa la marca en la que estás trabajando. 5. ## Vende una entrada y comprueba que llega Compra una entrada tú mismo y comprueba que la solicitud llega a tu dirección. **Nota:** La entrega ocurre en segundo plano, no durante el proceso de compra, así que espera unos segundos. Después, reembolsa tu propio pedido. ## Prueba estos pasos en tu propio evento Crea una cuenta gratis, monta tu evento y sigue los pasos de arriba en tu propio panel. Tarda unos minutos y no necesitas reservar una llamada comercial. Tu dirección de correo electrónico [Crear una cuenta gratis](https://manage.ticketfairy.com/welcome) [Reserva una demo](https://www.ticketfairy.com/es/event-ticketing/book-a-demo) Sin cuotas de alta. Sin cuota mensual obligatoria. Sin tarjeta de crédito. ## O deja que lo hagan por ti Fai puede abrir la página que contiene la clave del webhook. Los webhooks se crean desde la línea de comandos, y los pasos siguientes muestran los comandos. ### En tu panel, con Fai Abre la configuración de mi cuenta para que pueda obtener mi clave del webhook ### Desde tu propio asistente, por MCP Conecta tu asistente a [nuestro servidor MCP](https://www.ticketfairy.com/mcp-server) y pídele: Mantén `--read-only` en tu configuración MCP. Esta tarea solo lee datos, así que tu asistente no necesita herramientas que hagan cambios. Elige la marca \ y muestra sus eventos ## Desde tu terminal Instala la CLI desde [nuestra página de la CLI](https://www.ticketfairy.com/cli), inicia sesión con `ticketfairy auth login` y elige la marca con la que trabajas usando `ticketfairy brand use `. `ticketfairy brand list` y `ticketfairy event list` muestran los ID que usan los demás comandos. Crea el webhook y después consulta qué está escuchando. ### Llama a tu dirección cada vez que se realiza un pedido ticketfairy webhook create --url https://example.com/hooks/tickets --on order ### Muestra los webhooks de la marca activa ticketfairy webhook list ## Deja que Fai lo haga por ti Fai trabaja dentro de tu panel de Ticket Fairy. Crea tu cuenta, abre Fai y pega la instrucción de arriba. [Crear una cuenta gratis](https://manage.ticketfairy.com/welcome) [Reserva una demo](https://www.ticketfairy.com/es/event-ticketing/book-a-demo) Sin cuotas de alta. Sin cuota mensual obligatoria. Sin tarjeta de crédito. ## Retira uno del servicio 1. ### Desactívalo mientras trabajas por tu lado Ejecuta "ticketfairy webhook update \ --disable" y toma el ID de "ticketfairy webhook list". **Nota:** Un webhook desactivado conserva su configuración y deja de recibir solicitudes. Vuelve a activarlo con el mismo comando y "--enable". 2. ### Elimina uno que ya no necesites Ejecuta "ticketfairy webhook delete \" cuando ya no lo necesite nada. **Nota:** La eliminación es permanente, así que desactívalo primero si solo quieres pausarlo. Fai puede abrir el panel por ti. Actualmente, los webhooks se consultan y modifican desde la línea de comandos. ### En tu panel, con Fai Abre la configuración de mi cuenta ### Desde tu propio asistente, por MCP Mantén `--read-only` en tu configuración MCP. Esta tarea solo lee datos, así que tu asistente no necesita herramientas que hagan cambios. Elige la marca \ y muestra sus eventos ### Desde tu terminal Consulta los webhooks y después desactiva o elimina uno. #### Muestra los webhooks de la marca activa ticketfairy webhook list #### Deja de recibir un webhook sin eliminarlo ticketfairy webhook update \ --disable #### Elimina un webhook permanentemente ticketfairy webhook delete \ ## Preguntas que puedes tener ¿Por qué no llegó nada cuando mi evento se publicó?: Comprueba a qué está asociado el webhook. Las notificaciones de eventos solo llegan a los webhooks de la marca y de la gira, así que uno asociado a un único evento solo recibe avisos de pedidos. ¿Qué ocurre cuando mi dirección no funciona?: La entrega falla y se intenta la siguiente con normalidad. Responde 410 Gone y retiraremos el webhook de la lista; es la forma correcta de cancelar la suscripción desde tu lado. ¿Puedo comprobar que una solicitud procede realmente de Ticket Fairy?: Sí. Pide al equipo de asistencia de Ticket Fairy que añada un secreto de firma a tu evento. A partir de entonces, cada solicitud incluirá un encabezado X-Signature que tu endpoint recalculará con el mismo secreto. ¿Me llegará el mismo pedido más de una vez?: Sí. El pedido completo se vuelve a enviar cada vez que cambia, así que también se enviará con un reembolso, una cancelación, una reventa o una transferencia. Usa el número de pedido para identificarlo y aplica lo que recibas, en lugar de contar cada entrega como una venta nueva. ¿Puedo probar con una dirección local?: Se acepta una dirección http sencilla en tu propio equipo, así que un túnel es práctico, pero no obligatorio. Cada solicitud incluye datos del pedido y del comprador, así que usa http para las pruebas y proporciona una dirección HTTPS al sistema en producción. ## ¿Todavía tienes una pregunta? Reserva una demo y te la respondemos en una llamada, sobre tu tipo de evento. O crea tu cuenta y compruébalo por ti mismo. [Reserva una demo](https://www.ticketfairy.com/es/event-ticketing/book-a-demo) [Crear una cuenta gratis](https://manage.ticketfairy.com/welcome) Sin cuotas de alta. Sin cuota mensual obligatoria. Sin tarjeta de crédito. ## Guías relacionadas - [Más formas de usar Ticket Fairy](https://www.ticketfairy.com/es/event-ticketing/features) - [Create an API key so your own tools can read your ticket sales](https://www.ticketfairy.com/es/guides/create-an-api-key-for-your-own-app) - [¿Puedes vender entradas directamente desde tu propio sitio web?](https://www.ticketfairy.com/es/guides/sell-tickets-on-your-own-website) - [Sync your ticket buyers to Mailchimp](https://www.ticketfairy.com/es/guides/sync-buyers-to-mailchimp) - [Todas las guías de Ticket Fairy](https://www.ticketfairy.com/es/guides) ## Hazlo en tu propio evento Crea tu cuenta, monta tu evento y sigue los pasos en tu propio panel. No necesitas reservar una llamada comercial. [Crear una cuenta gratis](https://manage.ticketfairy.com/welcome) [Reserva una demo](https://www.ticketfairy.com/es/event-ticketing/book-a-demo) ## Vende entradas con Ticket Fairy Todo lo que ves en estas guías está en tu panel desde el día en que te registras. - Monta tu evento en minutos - Los eventos gratuitos son gratis - Fai, tu copiloto, viene incluida [Crear una cuenta gratis](https://manage.ticketfairy.com/welcome) Sin cuotas de alta. Sin cuota mensual obligatoria. Sin tarjeta de crédito. ## Míralo en una llamada Reserva una demo y te mostramos cómo Ticket Fairy gestiona tu tipo de evento. [Reserva una demo](https://www.ticketfairy.com/es/event-ticketing/book-a-demo) [Más formas de usar Ticket Fairy](https://www.ticketfairy.com/es/event-ticketing/features) ### Consejos para vender más entradas Consejos prácticos de organizadores que agotan entradas, y cada guía nueva en cuanto se publica. Respetamos tu privacidad. Cancela cuando quieras.