Skip to content
Guía del Centro de ayuda · Integraciones externas
4 min de lecturaVerificado 2026-11-16

Integraciones disponibles

Resumen de conectores en producción: API REST, Webhooks HMAC, URLs dinámicas, Widgets, FTP/SFTP y GA4.

En esta guía

Descripción general

Passinstance proporciona superficies de integración de primer nivel para plataformas de automatización sin código (Zapier, Make), tiendas de comercio electrónico, sistemas CRM, pasarelas de pago y nubes de marketing, configurables en Ajustes del espacio de trabajo -> Integraciones (/settings/workspace/integrations, /connectors, /connected-apps y /link-generator). Además de la API REST /api/v1 y los webhooks salientes, Passinstance expone una superficie de descubrimiento OAuth/iPaaS (Integrations API) y receptores de webhooks entrantes de proveedores sin prefijo (/webhooks/*).

Importante: Los endpoints entrantes para webhooks de proveedores (/webhooks/stripe, /webhooks/shopify, etc.) están excluidos explícitamente del prefijo global /api/v1 en main.ts para ajustarse de inmediato a las convenciones de URL de devolución de llamada y verificadores criptográficos de firma de proveedores externos.

Arquitectura de conectividad e integraciones

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
WEBHOOKS ENTRANTES DE PROVEEDORES Y SUPERFICIE OAUTH IPAAS
ACTORES DEL SISTEMA
P1 Plataformas SaaS / iPaaS externas
P2 Superficie API Passinstance
P3 Ejecución de dominio
PASO CTX CONTEXTO Zapier / Make / n8n
PASO 1 SOLICITUD / ACCIÓN GET/api/v1/me
›
(Connected Integrations API)
PASO 2 SOLICITUD / ACCIÓN GET/api/v1/templates/
›
Alcance OAuth: templates:read
›
:templateId/attributes
›
devuelve esquema dinámico
PASO 3 SOLICITUD / ACCIÓN POST/api/v1/webhook-subscriptions (targetUrl)
›
registra REST hook
PASO CTX CONTEXTO Stripe / Shopify / HubSpot / Klaviyo
PASO 4 SOLICITUD / ACCIÓN POST/webhooks/<vendor>
›
(Controladores de webhook)
›
Header: Firma HMAC del proveedor
›
Verificar firma proveedor
›
Emparejar externalId/Upsert
›
Emitir / Actualizar pase

Superficie de integración OAuth para Zapier y Make (Integrations API)

Los constructores de automatizaciones low-code se conectan a Passinstance mediante tokens Bearer OAuth 2.0 (OAuth 2.0 Authentication + Permission Scope Validation) bajo /api/v1:

MétodoEndpointAlcance OAuth requeridoFinalidad en Zapier / Make
GET/api/v1/meToken OAuth2 válidoVerifica las credenciales de conexión y devuelve el contexto autenticado del inquilino y usuario (Connected Integrations API).
GET/api/v1/templates/:templateId/attributestemplates:readRellena dinámicamente los campos personalizados de plantilla (memberName, points, tier) dentro del diseñador de acciones.
POST/api/v1/webhook-subscriptionswebhooks:writeRegistra una suscripción de webhook ({ event, targetUrl, metadata? }) cuando un usuario activa un Zap o escenario.
GET / DELETE/api/v1/webhook-subscriptionswebhooks:read / webhooks:writeLista o elimina suscripciones de webhooks gestionadas por OAuth (/api/v1/oauth/connections para la interfaz de aplicaciones conectadas).

Categorías compatibles de integration category

Al crear integraciones del espacio de trabajo (/api/v1/integrations), Passinstance clasifica los conectores mediante la enumeración integration category de Passinstance database con 21 valores: CRM, MARKETING_AUTOMATION, PAYMENT, TICKETING, GEOLOCATION, NOTIFICATIONS, ANALYTICS, INVENTORY, ACCOUNTING, CREATE_PASS_URL, FTP_JOB, IFRAME_PASS_DOWNLOAD, GOOGLE_ANALYTICS, NFC_PERSONALIZATION, PASS_DATA_FTP_UPLOAD, NAS_DATA_FTP_UPLOAD, FTP_IMPORT_JOB, FTP_EXPORT_JOB, EMBED_PASS_DOWNLOAD, WEB_ANALYTICS y PARAMETERIZED_PASS_LINK.

Rutas dedicadas de webhooks entrantes por proveedor (/webhooks/*)

Passinstance ofrece receptores de webhooks entrantes dedicados y verificados mediante firma para 10 plataformas principales de comercio, CRM, mensajería y eventos (además de /v1/automations/webhooks/shopify/:customerId y /woocommerce/:customerId para coincidencia de reglas multinquilino):

Plataforma proveedoraRuta de callback entranteEventos disparadores habituales atendidosAcción automatizada en Passinstance
StripePOST /webhooks/stripe y POST /webhooks/stripe/billingcheckout.session.completed, invoice.paid, customer.subscription.deletedEmite pases de membresía de pago (webhook de PassFlow también en /api/v1/pass-flows/public/webhooks/stripe) o los anula al cancelar.
ShopifyPOST /webhooks/shopifyorders/paid, orders/cancelled, customers/create, refunds/createEmite o actualiza tarjetas de fidelización o regalo (externalId) y anula vales reembolsados.
WooCommercePOST /webhooks/woocommerceorder.completed, order.refunded, customer.createdAprovisiona tarjetas de crédito en tienda, actualiza puntos de fidelización y sincroniza canjes de pedidos.
SalesforcePOST /webhooks/salesforceOutbound Message / Platform Event (Contact, Opportunity, CampaignMember)Emite pases VIP al cerrar oportunidades (X-Passinstance-Salesforce-Signature).
HubSpotPOST /webhooks/hubspotcontact.creation, contact.propertyChange, deal.propertyChangeInscribe contactos del CRM en Wallet Experiences y sincroniza cambios de nivel.
KlaviyoPOST /webhooks/klaviyoFlow Webhook Action (entrada en segmento, hito VIP, flujo de cumpleaños)Genera enlaces personalizados de pase o envía notificaciones push en pantalla de bloqueo.
TwilioPOST /webhooks/twilioCallbacks de estado de entrega de SMS e inscripciones por palabra clave SMSRegistra recibos de entrega de pases por SMS y emite pases cuando los clientes envían una palabra clave.
EventbritePOST /webhooks/eventbriteorder.placed, attendee.updated, attendee.checked_inEmite entradas para eventos en Apple/Google Wallet (.pkpass firmados con bundleId) y sincroniza el check-in en puerta.
TypeformPOST /webhooks/typeformWebhook de envío form_responseConvierte envíos de encuestas o formularios de captación directamente en pases Wallet personalizados.
Zoho CRMPOST /webhooks/zohoWebhook de regla de flujo (Leads, Contacts, Deals)Emite y actualiza tarjetas de miembro desde transiciones de flujo en Zoho CRM.

Opciones nativas adicionales de conectividad

  • Plugin nativo para Shopware 6: Suite completa de controladores de administración, escaparate, registro y webhooks (/shopware e Integraciones de comercio electrónico).
  • Sincronización programada por lotes FTP / SFTP: Trabajos nocturnos automatizados de importación y exportación CSV (FTP_IMPORT_JOB / FTP_EXPORT_JOB) para sistemas ERP heredados y POS de retail.
  • URLs dinámicas de Wallet y widgets incrustables: Generación de URLs firmadas (/settings/workspace/integrations/link-generator) y botones HTML listos para insertar (EMBED_PASS_DOWNLOAD, IFRAME_PASS_DOWNLOAD).

Explore todos los conectores en /integrations y descubra la automatización interna de reglas en Configuración de flujos de trabajo.

Documentación de producto y API relacionada

¿Listo para lanzar su primer programa de tarjetas Wallet?

Cree su espacio de trabajo, configure su plantilla y pruebe una tarjeta real en Apple Wallet y Google Wallet antes de escalar.