Skip to content
Guida del Centro assistenza · Integrazioni di terze parti
4 min di letturaVerificato 2026-11-16

Integrazioni disponibili

Panoramica dei connettori in produzione: API REST, Webhook HMAC, URL dinamici, Widget, FTP/SFTP e GA4.

In questa guida

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/v1 in main.ts affinché rispettino immediatamente le convenzioni rigorose sugli URL di callback e la verifica crittografica della firma dei rispettivi fornitori.

Architettura della connettività per le integrazioni

FLUSSO ARCHITETTURALE
ARCHITETTURA INTERATTIVA
WEBHOOK INGRESSO FORNITORI TERZI E SUPERFICIE OAUTH IPAAS
ATTORI DI SISTEMA COINVOLTI
P1 Piattaforme SaaS / iPaaS esterne
P2 Superficie API Passinstance
P3 Esecuzione di dominio
FASE CTX CONTESTO Zapier / Make / n8n
FASE 1 RICHIESTA / AZIONE GET/api/v1/me
›
(Connected Integrations API)
FASE 2 RICHIESTA / AZIONE GET/api/v1/templates/
›
Ambito OAuth: templates:read
›
:templateId/attributes
›
restituisce schema dinamico
FASE 3 RICHIESTA / AZIONE POST/api/v1/webhook-subscriptions (targetUrl)
›
registra REST hook
FASE CTX CONTESTO Stripe / Shopify / HubSpot / Klaviyo
FASE 4 RICHIESTA / AZIONE POST/webhooks/<vendor>
›
(Controller Webhook fornitori)
›
Header: Firma HMAC fornitore
›
Verifica firma fornitore
›
Abbina externalId / Upsert
›
Emette / Aggiorna pass

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:

MetodoEndpointAmbito OAuth richiestoScopo in Zapier / Make
GET/api/v1/meToken OAuth2 validoVerifica le credenziali di connessione e restituisce il contesto autenticato di tenant e utente (Connected Integrations API).
GET/api/v1/templates/:templateId/attributestemplates:readPopola dinamicamente i campi personalizzati del modello (memberName, points, tier) all'interno dell'editor di azioni.
POST/api/v1/webhook-subscriptionswebhooks:writeRegistra una sottoscrizione webhook ({ event, targetUrl, metadata? }) quando un utente attiva uno Zap o uno scenario.
GET / DELETE/api/v1/webhook-subscriptionswebhooks:read / webhooks:writeElenca 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 partnerRoute callback in ingressoEventi trigger tipici gestitiAzione automatica Passinstance
StripePOST /webhooks/stripe e POST /webhooks/stripe/billingcheckout.session.completed, invoice.paid, customer.subscription.deletedEmette tessere socio a pagamento (webhook PassFlow disponibile anche su /api/v1/pass-flows/public/webhooks/stripe) oppure le annulla alla cancellazione.
ShopifyPOST /webhooks/shopifyorders/paid, orders/cancelled, customers/create, refunds/createEmette/aggiorna carte fedeltà o gift card (externalId) e annulla i voucher rimborsati.
WooCommercePOST /webhooks/woocommerceorder.completed, order.refunded, customer.createdEmette carte credito negozio, aggiorna i punti fedeltà e sincronizza i riscatti degli ordini.
SalesforcePOST /webhooks/salesforceOutbound Message / Platform Event (Contact, Opportunity, CampaignMember)Emette pass VIP alla chiusura delle trattative (X-Passinstance-Salesforce-Signature).
HubSpotPOST /webhooks/hubspotcontact.creation, contact.propertyChange, deal.propertyChangeIscrive i contatti CRM nelle Wallet Experiences e sincronizza i cambi di livello.
KlaviyoPOST /webhooks/klaviyoFlow Webhook Action (ingresso segmento, traguardo VIP, flusso compleanno)Genera link pass personalizzati o attiva notifiche push in schermata di blocco.
TwilioPOST /webhooks/twilioCallback di stato consegna SMS e opt-in SMS in ingresso tramite parola chiaveTraccia le ricevute di consegna SMS dei pass ed emette pass quando i clienti inviano una parola chiave.
EventbritePOST /webhooks/eventbriteorder.placed, attendee.updated, attendee.checked_inEmette biglietti evento Apple/Google Wallet (.pkpass firmati con bundleId) e sincronizza il check-in ai varchi.
TypeformPOST /webhooks/typeformWebhook di invio form_responseConverte direttamente gli invii di sondaggi o moduli lead in pass Wallet personalizzati.
Zoho CRMPOST /webhooks/zohoWebhook 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.

Documentazione prodotto e API correlata

Pronto a lanciare il tuo primo programma di carte Wallet?

Crea il tuo workspace, configura il modello e testa una carta reale in Apple Wallet e Google Wallet prima di scalare.