Ir al contenido

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

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
    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.

  1. 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.

  2. 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.

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 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 <BRAND NAME> y muestra sus eventos

Desde tu terminal

Instala la CLI desde nuestra página de la CLI, inicia sesión con ticketfairy auth login y elige la marca con la que trabajas usando ticketfairy brand use <BRAND_ID>. 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 Reserva una 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 <ID> --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 <ID> 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 <BRAND NAME> 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 <WEBHOOK_ID> --disable

Elimina un webhook permanentemente

ticketfairy webhook delete <WEBHOOK_ID>

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 Crear una cuenta gratis

Sin cuotas de alta. Sin cuota mensual obligatoria. Sin tarjeta de crédito.

Guías relacionadas

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 Reserva una demo

Reserva una demo

Descubre cómo Ticket Fairy gestiona tus entradas, la puesta a la venta y el acceso al recinto. Elige la hora que te venga bien.

Videollamada de 45 minutos
Elige una hora que te funcione