Panoramica
Passinstance offre interfacce di integrazione di primo livello per piattaforme di automazione no-code (Zapier, Make), store e-commerce, sistemi CRM, gateway di pagamento e marketing cloud, configurabili in Impostazioni Workspace -> Integrazioni (/settings/workspace/integrations, /connectors, /connected-apps e /link-generator). Oltre alla REST API /api/v1 e ai webhook in uscita, Passinstance espone una superficie OAuth/iPaaS di discovery (Integrations API) e riceventi webhook dedicati privi di prefisso per provider terzi (/webhooks/*).
Importante: Gli endpoint webhook in ingresso dei provider terzi (
/webhooks/stripe,/webhooks/shopify, ecc.) sono esclusi esplicitamente dal prefisso globale/api/v1inmain.tsaffinché rispettino immediatamente le convenzioni rigorose sugli URL di callback e la verifica crittografica della firma dei rispettivi fornitori.
Architettura della connettività per le integrazioni
Interfaccia di integrazione OAuth per Zapier e Make (Integrations API)
I builder di automazione low-code si connettono a Passinstance tramite token Bearer OAuth 2.0 (OAuth 2.0 Authentication + Permission Scope Validation) sotto /api/v1:
| Metodo | Endpoint | Ambito OAuth richiesto | Scopo in Zapier / Make |
|---|---|---|---|
| GET | /api/v1/me | Token OAuth2 valido | Verifica le credenziali di connessione e restituisce il contesto autenticato di tenant e utente (Connected Integrations API). |
| GET | /api/v1/templates/:templateId/attributes | templates:read | Popola dinamicamente i campi personalizzati del modello (memberName, points, tier) all'interno dell'editor di azioni. |
| POST | /api/v1/webhook-subscriptions | webhooks:write | Registra una sottoscrizione webhook ({ event, targetUrl, metadata? }) quando un utente attiva uno Zap o uno scenario. |
GET / DELETE | /api/v1/webhook-subscriptions | webhooks:read / webhooks:write | Elenca o rimuove le sottoscrizioni webhook gestite via OAuth (/api/v1/oauth/connections per la UI delle app connesse). |
Categorie integration category supportate
Quando si creano integrazioni del workspace (/api/v1/integrations), Passinstance classifica i connettori mediante l'enum Passinstance database a 21 valori integration category: 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 e PARAMETERIZED_PASS_LINK.
Route webhook dedicate in ingresso per provider (/webhooks/*)
Passinstance mette a disposizione riceventi webhook dedicati con verifica firma per 10 principali piattaforme commerce, CRM, messaggistica ed eventi (oltre a /v1/automations/webhooks/shopify/:customerId e /woocommerce/:customerId per il matching multi-tenant delle regole di storefront):
| Piattaforma partner | Route callback in ingresso | Eventi trigger tipici gestiti | Azione automatica Passinstance |
|---|---|---|---|
| Stripe | POST /webhooks/stripe e POST /webhooks/stripe/billing | checkout.session.completed, invoice.paid, customer.subscription.deleted | Emette tessere socio a pagamento (webhook PassFlow disponibile anche su /api/v1/pass-flows/public/webhooks/stripe) oppure le annulla alla cancellazione. |
| Shopify | POST /webhooks/shopify | orders/paid, orders/cancelled, customers/create, refunds/create | Emette/aggiorna carte fedeltà o gift card (externalId) e annulla i voucher rimborsati. |
| WooCommerce | POST /webhooks/woocommerce | order.completed, order.refunded, customer.created | Emette carte credito negozio, aggiorna i punti fedeltà e sincronizza i riscatti degli ordini. |
| Salesforce | POST /webhooks/salesforce | Outbound Message / Platform Event (Contact, Opportunity, CampaignMember) | Emette pass VIP alla chiusura delle trattative (X-Passinstance-Salesforce-Signature). |
| HubSpot | POST /webhooks/hubspot | contact.creation, contact.propertyChange, deal.propertyChange | Iscrive i contatti CRM nelle Wallet Experiences e sincronizza i cambi di livello. |
| Klaviyo | POST /webhooks/klaviyo | Flow Webhook Action (ingresso segmento, traguardo VIP, flusso compleanno) | Genera link pass personalizzati o attiva notifiche push in schermata di blocco. |
| Twilio | POST /webhooks/twilio | Callback di stato consegna SMS e opt-in SMS in ingresso tramite parola chiave | Traccia le ricevute di consegna SMS dei pass ed emette pass quando i clienti inviano una parola chiave. |
| Eventbrite | POST /webhooks/eventbrite | order.placed, attendee.updated, attendee.checked_in | Emette biglietti evento Apple/Google Wallet (.pkpass firmati con bundleId) e sincronizza il check-in ai varchi. |
| Typeform | POST /webhooks/typeform | Webhook di invio form_response | Converte direttamente gli invii di sondaggi o moduli lead in pass Wallet personalizzati. |
| Zoho CRM | POST /webhooks/zoho | Webhook delle regole di workflow (Leads, Contacts, Deals) | Emette e aggiorna tessere socio dalle transizioni di workflow in Zoho CRM. |
Opzioni aggiuntive di connettività nativa
-
Plugin nativo Shopware 6: Suite completa di controller per admin, storefront, registrazione e webhook (/shopware e Integrazioni e-commerce).
-
Sincronizzazione batch pianificata FTP / SFTP: Job notturni automatizzati di importazione ed esportazione CSV (
FTP_IMPORT_JOB/FTP_EXPORT_JOB) per ERP legacy e POS retail. -
URL dinamici Wallet e widget incorporabili: Generazione di URL firmati (
/settings/workspace/integrations/link-generator) e pulsanti HTML pronti all'uso (EMBED_PASS_DOWNLOAD,IFRAME_PASS_DOWNLOAD).
Esplori tutti i connettori su /integrations e approfondisca l'automazione interna delle regole in Configurazione dei workflow.
