Tres formas de conectar PA55
| Herramienta | Para qué sirve | Dónde se configura |
|---|---|---|
| Webhooks | PA55 le avisa a tu CRM (FunnelChat, Make, Zapier, tu servidor) en el momento en que pasa algo. | Panel del evento > Configuración > Webhooks |
| API v1 | Tu sistema le pregunta a PA55 por tus eventos, ventas y asistentes, y puede crear o editar eventos. | Configuración > API y Claude |
| Conector MCP | Claude o ChatGPT consultan y editan tu cuenta en lenguaje natural. | En Claude o ChatGPT, agregando el conector de PA55 |
Ninguna de las tres mueve dinero: reembolsos, retiros y cortesías solo se hacen desde el panel.
Tutorial: conecta tu CRM a un evento en 5 pasos
Ejemplo real: FunnelChat de Roto3 para Common Groove • Celaya • 21/11/26. Sirve igual para cualquier CRM que reciba un POST con JSON.
1. Define el código del evento. Formato sugerido marca-ciudad-DDMMAA en minúsculas, por ejemplo cg-cel-211126. Viaja en cada aviso como event_code para que tu CRM etiquete a la persona con ese evento.
2. Crea en tu CRM un flujo por tipo de aviso. Pre-registro, compra, reembolso y entrada en puerta. Cada flujo te da una URL.
3. En PA55, abre el evento > Configuración. Escribe el código en «Código del evento en tu CRM». Al guardarlo, el WhatsApp se vuelve obligatorio y validado al comprar y al pre-registrarse en ese evento.
4. En la misma pantalla, en Webhooks, agrega cada URL y marca solo su tipo. Una URL para Pre-registro, otra para Compra, otra para Reembolso y otra para Entrada en puerta. Hasta 5 URLs por evento.
5. Prueba antes de abrir la venta. Manda un aviso de ejemplo a cada URL con un teléfono de prueba (no de un cliente) y revisa en tu CRM que la etiqueta llegó. El botón «Enviar prueba» del panel solo confirma que la URL responde: manda un pre-registro de ejemplo con un teléfono falso.
Agrega las URLs dentro del evento, no en los ajustes de la cuenta. Una URL de cuenta recibe los avisos de todos tus eventos, y las etiquetas se mezclan.
curl -X POST "https://TU-URL-DE-PAGO" \
-H "Content-Type: application/json" \
-d '{"event":"order.paid","data":{"phone":"+524421234567","name":"PRUEBA","email":"prueba@tu-dominio.com","event_code":"cg-cel-211126","order_id":"TEST-001","paid_at":"2026-10-27 19:05:00","ticket_type":"Earlybird","quantity":1,"amount":199,"orders_count":1,"ref":"test","whatsapp_optin":true}}'Cómo llega cada aviso
Un POST con Content-Type: application/json a tu URL, en el momento en que pasa (no en lote). Todos tienen la misma forma: event, created_at y los datos dentro de data.
X-PA55-Event: el tipo de aviso.X-PA55-Signature: HMAC-SHA256 en hexadecimal del cuerpo crudo, firmado con el secreto de esa URL (lo ves en el panel). Verificarla es opcional, pero recomendado si tu URL es pública.- Tiempo de espera: 10 segundos. Si tu URL responde con error o no responde, PA55 reintenta a 1, 5 y 30 minutos con el mismo cuerpo. Después del tercer reintento el aviso queda registrado como fallido.
- Horas:
created_atva en UTC (ISO 8601).paid_at,refunded_atychecked_in_atvan comoAAAA-MM-DD HH:MM:SSen hora de Ciudad de México. - Responde 2xx rápido y procesa después. Un aviso puede llegar dos veces si tu servidor tardó en contestar: usa
order_id(opreregistration_id) para no duplicar.
import crypto from "node:crypto"
// body = el cuerpo crudo (string), tal cual llego, antes de JSON.parse
export function isFromPa55(body, signatureHeader, secret) {
const expected = crypto.createHmac("sha256", secret).update(body).digest("hex")
const got = Buffer.from(signatureHeader || "", "utf8")
const want = Buffer.from(expected, "utf8")
return got.length === want.length && crypto.timingSafeEqual(got, want)
}Los 4 avisos y su JSON exacto
| Aviso | Cuándo sale |
|---|---|
preregistration.created | Alguien completa el pre-registro del evento. |
order.paid | La pasarela confirma el pago. Una vez por orden, nunca al abrir el checkout. |
order.refunded | La orden queda devuelta completa: reembolso del organizador, aviso de la pasarela o contracargo. Un reembolso parcial no lo dispara. |
attendee.checked_in | Se escanea un lugar en la puerta, también si el escáner estaba sin señal y lo sube después. Uno por lugar. |
order_ides el ID de la orden (UUID). Es el mismo en el pago, el reembolso y las entradas de esa orden.amountes el total cobrado en MXN, sin símbolo.refva vacío si no hubo?ref=.orders_countcuenta las órdenes pagadas de ese teléfono en todos los eventos de tu cuenta, incluida esta.preregistereddice si ese correo se pre-registró al evento.- En
attendee.checked_in,phonees el del comprador yname/emaillos del asistente de ese lugar. Una orden de 3 que entran los 3 manda 3 avisos con el mismo teléfono. reasonen el reembolso esrefundochargeback.
{
"event": "order.paid",
"created_at": "2026-10-28T01:05:00.000Z",
"data": {
"order_id": "0b7e2c1a-...",
"name": "María Fernández",
"email": "maria@correo.com",
"phone": "+524611234567",
"paid_at": "2026-10-27 19:05:00",
"ticket_type": "Earlybird",
"quantity": 2,
"amount": 398,
"currency": "mxn",
"ref": "wa-aviso2_cg",
"whatsapp_optin": true,
"marketing_consent": true,
"orders_count": 1,
"preregistered": true,
"preregistration_id": "6f1c9e0d-...",
"event_code": "cg-cel-211126",
"event_info": { "id": "d2f72cd6-...", "title": "Common Groove", "slug": "common-groove", "date": "2026-11-21T22:00:00+00:00" }
}
}{
"event": "preregistration.created",
"created_at": "2026-10-27T18:02:26.062Z",
"data": {
"preregistration_id": "6f1c9e0d-...",
"name": "María Fernández",
"email": "maria@correo.com",
"phone": "+524611234567",
"custom_data": {},
"locale": "es",
"whatsapp_optin": true,
"event_code": "cg-cel-211126",
"event_info": { "id": "d2f72cd6-...", "title": "Common Groove", "slug": "common-groove", "date": "2026-11-21T22:00:00+00:00" }
}
}{
"event": "order.refunded",
"created_at": "2026-10-29T18:40:00.000Z",
"data": {
"order_id": "0b7e2c1a-...",
"name": "María Fernández",
"email": "maria@correo.com",
"phone": "+524611234567",
"amount_refunded": 398,
"refunded_at": "2026-10-29 12:40:00",
"reason": "refund",
"event_code": "cg-cel-211126",
"event_info": { "...": "..." }
}
}{
"event": "attendee.checked_in",
"created_at": "2026-11-22T05:14:08.000Z",
"data": {
"order_id": "0b7e2c1a-...",
"name": "Ana López",
"email": "ana@correo.com",
"phone": "+524611234567",
"checked_in_at": "2026-11-21 23:14:08",
"event_code": "cg-cel-211126",
"event_info": { "...": "..." }
}
}Teléfono, consentimiento y origen de la venta
Teléfono. Con «Código del evento en tu CRM» puesto, es obligatorio en compra y pre-registro: uno por orden, el del comprador. Se guarda y se manda como +52 y 10 dígitos, sin espacios: +524611234567. México exige exactamente 10 dígitos; otras ladas, de 8 a 15. El checkout no deja pagar con un número imposible y el servidor también lo rechaza.
Consentimiento. Casilla sin palomear: «Quiero recibir por WhatsApp avisos de este y otros eventos de {organizador}. Puedo darme de baja escribiendo BAJA.», con link al aviso de privacidad. Llega como whatsapp_optin. El organizador es el primero de «Organizado por» del evento.
Origen (?ref=). Cualquier link del evento acepta ?ref=, por ejemplo pa55.app/events/common-groove?ref=wa-aviso2_cg. Se recuerda en ese navegador para ese evento (gana el último), se guarda en la orden y viaja en order.paid. Letras, números, -, _ y ., hasta 80. Se combina con el link de RP: pa55.app/events/common-groove/r/CODIGO?ref=...
Prellenado. El link personal del aviso «ya abrió la venta» prellena nombre, correo y teléfono del pre-registro, para que la persona compre con el mismo número.
API v1: lee y edita tus eventos
Base https://pa55.app/api/v1. Autenticación con Authorization: Bearer p55_.... Las llaves se crean en Configuración > API y Claude: eliges los permisos y la vigencia.
- Límite: 120 peticiones por minuto por llave (
429conRetry-After). - Un recurso de otra cuenta responde
404, no403. Llave inválida o vencida:401. Falta de permiso:403 missing_scope. - Cancelar eventos, reembolsar y dar cortesías no se puede por API.
| Ruta | Permiso | Qué hace |
|---|---|---|
GET /me | profile:read | Perfiles que alcanza la llave |
GET /events?when=upcoming|past | events:read | Tus eventos |
POST /events | events:write | Crea un evento en borrador |
GET /events/:id | events:read | Un evento con sus tipos de boleto |
PATCH /events/:id | events:write | Edita un evento; status acepta draft o published |
POST /events/:id/tiers | events:write | Agrega un tipo de boleto |
PATCH /events/:id/tiers/:tierId | events:write | Edita un tipo de boleto |
GET /events/:id/sales | sales:read | Ventas netas de reembolsos, aforo y reparto por tipo |
GET /events/:id/attendees | attendees:read | Una fila por persona con acceso vivo |
GET /tickets?email= | attendees:read | Boletos de una persona en tus eventos |
curl https://pa55.app/api/v1/events?when=upcoming \
-H "Authorization: Bearer p55_tu_llave"
curl https://pa55.app/api/v1/events/EVENT_ID/sales \
-H "Authorization: Bearer p55_tu_llave"{ "error": { "code": "missing_scope", "message": "..." } }Opera tu cuenta desde Claude o ChatGPT
PA55 tiene un conector MCP en https://pa55.app/api/mcp. En Claude o ChatGPT agrega un conector personalizado con esa URL e inicia sesión con tu cuenta de PA55: no hay que copiar llaves.
Lo que el asistente puede hacer: ver tus perfiles y eventos, consultar ventas y asistentes, crear eventos en borrador, editar eventos y tipos de boleto, y publicar o despublicar. Antes de publicar te pide confirmación.
p55_me,p55_list_events,p55_get_eventp55_event_sales,p55_event_attendeesp55_create_event,p55_update_event,p55_add_ticket_type,p55_update_ticket_typep55_publish_event,p55_unpublish_event
Igual que la API, el conector no mueve dinero.
¿Algo no llega?
- Revisa en el panel del evento > Configuración > Webhooks el último estado de cada URL (código HTTP y error).
- Confirma que cada URL tiene marcado solo su tipo de aviso y que el evento tiene código CRM.
- Si tu CRM pide un campo con otro nombre (
telefonoen vez dephone), el dato se pierde sin error: usa los nombres de esta guía.
Para dudas técnicas escríbenos desde el chat de soporte del panel. Si nos mandas la hora del aviso y el order_id, lo rastreamos.