Visão Geral das Integrações
O MIDDAG Account centraliza suas operações B2B sem substituir as ferramentas que sua equipe já utiliza. O Stripe cuida dos pagamentos, o HubSpot gerencia o pipeline de CRM, o Jira rastreia solicitações de serviço e o ISSNet emite notas fiscais. O plugin fica no centro, conectando fluxos de dados e mantendo tudo sincronizado.
Filosofia
Três princípios orientam a abordagem do MIDDAG Account em relação às integrações:
- Centralizar, não substituir. Cada sistema externo continua sendo a autoridade no que faz melhor. O MIDDAG Account lê, sincroniza e orquestra -- não duplica funcionalidades.
- Webhook primeiro. As integrações preferem webhooks em tempo real em vez de polling periódico. Polling é utilizado apenas quando o sistema externo não suporta webhooks (ISSNet).
- Degradação graciosa. Se um serviço externo estiver fora do ar, o plugin continua funcionando. A sincronização se recupera automaticamente quando a conexão é restabelecida.
ConnectorRegistry
Todas as integrações passam pelo ConnectorRegistry, um componente central que mapeia organizações aos seus conectores configurados. Quando um evento de domínio é disparado (um pedido é pago, um entitlement é ativado), o registry resolve a instância correta do conector para a organização envolvida.
O registry suporta configuração por organização. Uma organização vinculada à entidade brasileira utiliza o Stripe BR e o HubSpot BR; uma organização internacional utiliza os equivalentes nos EUA. A configuração é armazenada de forma criptografada nas opções do WordPress.
Integrações disponíveis
Estas integrações estão implementadas e funcionando na versão atual.
| Integração | Direção | O que faz |
|---|---|---|
| Stripe | Bidirecional | Processamento de pagamentos, assinaturas, faturas, reembolsos |
| HubSpot | Bidirecional | Sincronização de CRM, pipelines de negócios, ciclo de vida de cotações |
| ISSNet | Saída | Geração de nota fiscal de serviço (NFSe) via SOAP |
| Banco Inter | Entrada | Pagamentos via Pix e Boleto para o Brasil |
| Cloudflare | Saída | Banco de dados na edge D1 e armazenamento de objetos R2 |
| Jira | Bidirecional | Sincronização de solicitações de serviço, worklogs, acompanhamento de SLA |
| WooCommerce | Bidirecional | Pedidos, produtos, assinaturas |
| SolidAffiliate | Entrada | Programa de parceiros, indicações, comissões |
Integrações planejadas
| Integração | Descrição |
|---|---|
| Chatwoot | Suporte ao cliente via chat com contexto de entitlement |
| Webhooks de saída | Catálogo de eventos para notificar sistemas externos |
Suporte a contas duplas
A MIDDAG opera duas entidades jurídicas: MIDDAG Tecnologia LTDA (Brasil, BRL) e MIDDAG, LLC (Estados Unidos, USD). Tanto o Stripe quanto o HubSpot operam em modo de conta dupla, com credenciais separadas, endpoints de webhook e registros de clientes por entidade. O plugin faz o roteamento automaticamente com base na entidade de faturamento da organização.
Saúde das integrações
Cada webhook de entrada é registrado com timestamp, direção, hash do payload e resultado do processamento. Eventos com falha são retentados com backoff exponencial. O dashboard admin exibe a saúde das integrações para que você identifique problemas antes que afetem os clientes.
Indicadores-chave de saúde:
- Taxa de processamento de webhooks -- percentual de webhooks processados com sucesso nas últimas 24 horas.
- Atraso de sincronização -- tempo desde a última sincronização bem-sucedida para cada integração.
- Eventos com falha -- quantidade de eventos que esgotaram as tentativas de retentativa e requerem revisão manual.
Idempotência
Todos os handlers de webhook são idempotentes. Eventos duplicados (comuns durante retentativas) não criam registros duplicados. Cada handler verifica o ID do evento contra eventos processados anteriormente antes de executar qualquer ação.
Trilha de auditoria
Cada evento de integração é registrado com:
- Timestamp
- Direção (entrada ou saída)
- Hash do payload
- Status de processamento (sucesso, falha, ignorado)
- Integração e conta de origem
Essa trilha é essencial para depuração de problemas de sincronização e para auditoria de conformidade.
Próximos passos
- Stripe -- processamento de pagamentos com conta dupla
- HubSpot -- sincronização de CRM e pipelines de negócios
- ISSNet -- notas fiscais de serviço brasileiras
- Banco Inter -- pagamentos via Pix e Boleto
- Cloudflare -- banco de dados na edge e armazenamento de objetos
- Jira -- sincronização de solicitações de serviço
- Chatwoot -- suporte ao cliente (planejado)
- Webhooks -- notificações de eventos de saída
- Status das Integrações -- matriz completa de status