Skip to content
Guia da Central de Ajuda · Integrações externas
4 min de leituraVerificado 2026-11-16

Integrações disponíveis

Panorama das ligações em produção: API REST, Webhooks HMAC, URLs dinâmicos, Widgets, FTP/SFTP e GA4.

Neste guia

Visão Geral

O Passinstance disponibiliza superfícies de integração de primeira classe para plataformas de automatização sem código (Zapier, Make), montras de comércio eletrónico, sistemas CRM, processadores de pagamentos e clouds de marketing, configuradas em Definições do Espaço de Trabalho -> Integrações (/settings/workspace/integrations, /connectors, /connected-apps e /link-generator). Além da API REST /api/v1 e dos webhooks de saída, o Passinstance expõe uma superfície de descoberta OAuth/iPaaS (Integrations API) e recetores de webhooks de entrada de fornecedores sem prefixo (/webhooks/*).

Importante: Os endpoints de webhooks de entrada de fornecedores (/webhooks/stripe, /webhooks/shopify, etc.) estão explicitamente excluídos do prefixo global /api/v1 em main.ts, para que correspondam imediatamente às convenções estritas de URLs de callback e aos verificadores de assinatura criptográfica de fornecedores terceiros.

Arquitetura de Conectividade de Integrações

FLUXO DE ARQUITETURA
ARQUITETURA INTERATIVA
WEBHOOKS DE ENTRADA E SUPERFÍCIE OAUTH IPAAS
ATORES DE SISTEMA PARTICIPANTES
P1 Plataformas SaaS / iPaaS Externas
P2 Superfície de API Passinstance
P3 Execução de Domínio
ETAPA CTX CONTEXTO Zapier / Make / n8n
ETAPA 1 PEDIDO / AÇÃO GET/api/v1/me
›
(Connected Integrations API)
ETAPA 2 PEDIDO / AÇÃO GET/api/v1/templates/
›
Âmbito OAuth: templates:read
›
:templateId/attributes
›
devolve esquema dinâmico
ETAPA 3 PEDIDO / AÇÃO POST/api/v1/webhook-subscriptions (targetUrl)
›
regista hook REST
ETAPA CTX CONTEXTO Stripe / Shopify / HubSpot / Klaviyo
ETAPA 4 PEDIDO / AÇÃO POST/webhooks/<vendor>
›
(Controladores de Fornecedores)
›
Header: Assinatura HMAC
›
Verificar assinatura
›
Corresponder externalId
›
Emitir / Atualizar Passe

Superfície de Integração OAuth para Zapier e Make (Integrations API)

Os construtores de automatização low-code ligam-se ao Passinstance através de tokens Bearer OAuth 2.0 (OAuth 2.0 Authentication + Permission Scope Validation) sob /api/v1:

MétodoEndpointÂmbito OAuth NecessárioFinalidade no Zapier / Make
GET/api/v1/meToken OAuth2 válidoVerifica as credenciais de ligação e devolve o contexto autenticado do tenant e do utilizador (Connected Integrations API).
GET/api/v1/templates/:templateId/attributestemplates:readPreenche dinamicamente os campos personalizados do modelo (memberName, points, tier) dentro do editor de ações.
POST/api/v1/webhook-subscriptionswebhooks:writeRegista uma subscrição de webhook ({ event, targetUrl, metadata? }) quando um utilizador ativa um Zap ou cenário.
GET / DELETE/api/v1/webhook-subscriptionswebhooks:read / webhooks:writeLista ou remove subscrições de webhooks geridas por OAuth (/api/v1/oauth/connections para a interface de aplicações ligadas).

Categorias integration category Suportadas

Ao criar integrações no espaço de trabalho (/api/v1/integrations), o Passinstance classifica os conectores utilizando o integration category do Passinstance database com 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 e PARAMETERIZED_PASS_LINK.

Rotas Dedicadas de Webhooks de Entrada de Fornecedores (/webhooks/*)

O Passinstance disponibiliza recetores dedicados de webhooks de entrada com verificação de assinatura para 10 grandes plataformas de comércio, CRM, mensagens e eventos (além de /v1/automations/webhooks/shopify/:customerId e /woocommerce/:customerId para correspondência multi-tenant de regras de montra):

Plataforma do FornecedorRota de Callback de EntradaEventos Acionadores Típicos ProcessadosAção Automatizada no Passinstance
StripePOST /webhooks/stripe e POST /webhooks/stripe/billingcheckout.session.completed, invoice.paid, customer.subscription.deletedEmite passes de adesão pagos (webhook de PassFlow também em /api/v1/pass-flows/public/webhooks/stripe) ou anula em caso de cancelamento.
ShopifyPOST /webhooks/shopifyorders/paid, orders/cancelled, customers/create, refunds/createEmite/atualiza cartões de fidelização ou cartões-presente (externalId) e anula vales reembolsados.
WooCommercePOST /webhooks/woocommerceorder.completed, order.refunded, customer.createdAprovisiona cartões de crédito de loja, atualiza pontos de fidelização e sincroniza resgates de encomendas.
SalesforcePOST /webhooks/salesforceOutbound Message / Evento de Plataforma (Contact, Opportunity, CampaignMember)Emite passes VIP quando negócios são fechados (X-Passinstance-Salesforce-Signature).
HubSpotPOST /webhooks/hubspotcontact.creation, contact.propertyChange, deal.propertyChangeInscreve contactos de CRM em Experiências na Carteira e sincroniza alterações de escalão.
KlaviyoPOST /webhooks/klaviyoAção de Webhook de Fluxo (Entrada em segmento, marco VIP, fluxo de aniversário)Gera ligações de passes personalizadas ou aciona notificações push no ecrã bloqueado.
TwilioPOST /webhooks/twilioCallbacks de estado de entrega SMS e adesões por palavra-chave SMS de entradaMonitoriza recibos de entrega de passes por SMS e emite passes quando os clientes enviam uma palavra-chave por mensagem.
EventbritePOST /webhooks/eventbriteorder.placed, attendee.updated, attendee.checked_inEmite bilhetes de eventos Apple/Google Wallet (.pkpass assinado com bundleId) e sincroniza o estado de registo de entrada na porta.
TypeformPOST /webhooks/typeformWebhook de submissão form_responseConverte submissões de inquéritos ou formulários de angariação de contactos diretamente em passes de carteira personalizados.
Zoho CRMPOST /webhooks/zohoWebhook de regra de fluxo de trabalho (Leads, Contacts, Deals)Emite e atualiza cartões de membro a partir de transições de fluxo de trabalho no Zoho CRM.

Opções Adicionais de Conectividade Nativa

  • Plugin Nativo Shopware 6: Suíte completa de controladores de administração, montra, registo e webhooks (/shopware e Integrações de Comércio Eletrónico).
  • Sincronização Agendada em Lote FTP / SFTP: Tarefas noturnas automatizadas de importação e exportação CSV (FTP_IMPORT_JOB / FTP_EXPORT_JOB) para sistemas ERP tradicionais e POS de retalho.
  • URLs Dinâmicos de Carteira e Widgets Incorporáveis: Geração de URLs assinados (/settings/workspace/integrations/link-generator) e botões HTML prontos a incorporar (EMBED_PASS_DOWNLOAD, IFRAME_PASS_DOWNLOAD).

Explore todos os conectores em /integrations e descubra a automatização interna de regras em Configuração de Fluxos de Trabalho.

Documentação de produto e API relacionada

Pronto para lançar o seu primeiro programa de cartões Wallet?

Crie o seu espaço de trabalho, configure o seu modelo e teste um cartão real na Apple Wallet e Google Wallet antes de escalar.