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/v1enmain.tspara 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
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étodo | Endpoint | Alcance OAuth requerido | Finalidad en Zapier / Make |
|---|---|---|---|
| GET | /api/v1/me | Token OAuth2 válido | Verifica las credenciales de conexión y devuelve el contexto autenticado del inquilino y usuario (Connected Integrations API). |
| GET | /api/v1/templates/:templateId/attributes | templates:read | Rellena dinámicamente los campos personalizados de plantilla (memberName, points, tier) dentro del diseñador de acciones. |
| POST | /api/v1/webhook-subscriptions | webhooks:write | Registra una suscripción de webhook ({ event, targetUrl, metadata? }) cuando un usuario activa un Zap o escenario. |
GET / DELETE | /api/v1/webhook-subscriptions | webhooks:read / webhooks:write | Lista 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 proveedora | Ruta de callback entrante | Eventos disparadores habituales atendidos | Acción automatizada en Passinstance |
|---|---|---|---|
| Stripe | POST /webhooks/stripe y POST /webhooks/stripe/billing | checkout.session.completed, invoice.paid, customer.subscription.deleted | Emite pases de membresía de pago (webhook de PassFlow también en /api/v1/pass-flows/public/webhooks/stripe) o los anula al cancelar. |
| Shopify | POST /webhooks/shopify | orders/paid, orders/cancelled, customers/create, refunds/create | Emite o actualiza tarjetas de fidelización o regalo (externalId) y anula vales reembolsados. |
| WooCommerce | POST /webhooks/woocommerce | order.completed, order.refunded, customer.created | Aprovisiona tarjetas de crédito en tienda, actualiza puntos de fidelización y sincroniza canjes de pedidos. |
| Salesforce | POST /webhooks/salesforce | Outbound Message / Platform Event (Contact, Opportunity, CampaignMember) | Emite pases VIP al cerrar oportunidades (X-Passinstance-Salesforce-Signature). |
| HubSpot | POST /webhooks/hubspot | contact.creation, contact.propertyChange, deal.propertyChange | Inscribe contactos del CRM en Wallet Experiences y sincroniza cambios de nivel. |
| Klaviyo | POST /webhooks/klaviyo | Flow 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. |
| Twilio | POST /webhooks/twilio | Callbacks de estado de entrega de SMS e inscripciones por palabra clave SMS | Registra recibos de entrega de pases por SMS y emite pases cuando los clientes envían una palabra clave. |
| Eventbrite | POST /webhooks/eventbrite | order.placed, attendee.updated, attendee.checked_in | Emite entradas para eventos en Apple/Google Wallet (.pkpass firmados con bundleId) y sincroniza el check-in en puerta. |
| Typeform | POST /webhooks/typeform | Webhook de envío form_response | Convierte envíos de encuestas o formularios de captación directamente en pases Wallet personalizados. |
| Zoho CRM | POST /webhooks/zoho | Webhook 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.
