Integrações
O painel de Integrações exibe o status de todos os serviços externos conectados ao MIDDAG Account. Esta é a tela única onde você verifica se as integrações estão saudáveis, confere quando ocorreu a última sincronização e aciona verificações manuais de saúde quando algo parece fora do normal.
Acessando o painel
Navegue até MIDDAG Account > Configurações e selecione a aba Integrações.
Visão geral do status das integrações
Cada serviço conectado é exibido como um cartão com um indicador de status:
| Indicador | Cor | Significado |
|---|---|---|
| Saudável | Verde | Integração conectada e operando normalmente |
| Alerta | Amarelo | Integração conectada mas com problemas (ex.: sincronização desatualizada, rate-limited) |
| Erro | Vermelho | Integração desconectada ou falhando |
Serviços conectados
HubSpot CRM
A MIDDAG utiliza portais HubSpot duplos: um para MIDDAG BR e outro para MIDDAG GLOBAL.
| Campo | MIDDAG BR | MIDDAG GLOBAL |
|---|---|---|
| Portal ID | ID do portal HubSpot BR | ID do portal HubSpot GLOBAL |
| Status | Indicador de saúde | Indicador de saúde |
| Última Sincronização | Carimbo de data/hora do último webhook recebido | Carimbo de data/hora do último webhook recebido |
| Objetos Sincronizados | Contatos, Empresas, Negócios, Orçamentos | Contatos, Empresas, Negócios, Orçamentos |
| URL do Webhook | O endpoint que recebe webhooks do HubSpot | O endpoint que recebe webhooks do HubSpot |
Ações:
- Testar Conexão -- enviar uma chamada de API de teste para verificar credenciais
- Forçar Sincronização -- acionar uma sincronização completa de contatos e empresas
- Ver Log de Webhooks -- exibir entregas recentes de webhooks e seu status de processamento
Stripe
Contas Stripe duplas para cobrança BR e GLOBAL.
| Campo | MIDDAG BR | MIDDAG GLOBAL |
|---|---|---|
| Account ID | ID da conta Stripe BR | ID da conta Stripe GLOBAL |
| Status | Indicador de saúde | Indicador de saúde |
| Último Webhook | Carimbo de data/hora do último evento | Carimbo de data/hora do último evento |
| Eventos Rastreados | invoice.paid, invoice.payment_failed, subscription.updated, subscription.deleted, charge.refunded | Idem |
| URL do Webhook | O endpoint que recebe webhooks do Stripe | O endpoint que recebe webhooks do Stripe |
Ações:
- Testar Conexão -- verificar validade da chave de API
- Ver Log de Webhooks -- exibir eventos recentes e status de processamento
Banco Inter
Gateway de pagamento para transações brasileiras via Pix e Boleto.
| Campo | O que exibe |
|---|---|
| Status | Indicador de saúde |
| Gateway | Status do plugin WooCommerce Banco Inter |
| Último Pagamento | Carimbo de data/hora do último pagamento recebido |
Ações:
- Testar Conexão -- verificar certificado e credenciais da API
ISSNet (NFSe)
Emissão de nota fiscal de serviço para o município de Brasília/DF.
| Campo | O que exibe |
|---|---|
| Status | Indicador de saúde |
| Município | Brasília/DF |
| Última Emissão | Carimbo de data/hora da última NFSe bem-sucedida |
| Pendentes | Contagem de faturas aguardando emissão de NFSe |
| Status do Cron | Se o cron de verificação de status a cada 5 minutos está ativo |
Ações:
- Testar Conexão -- enviar uma requisição SOAP de teste ao ISSNet
- Retentar Falhadas -- tentar novamente solicitações de emissão de NFSe que falharam
Jira
Integração para criação de tickets de suporte a partir de pedidos WooCommerce.
| Campo | O que exibe |
|---|---|
| Status | Indicador de saúde |
| Projeto | Chave do projeto Jira Service Management |
| Último Ticket | Carimbo de data/hora do último ticket Jira criado |
Ações:
- Testar Conexão -- verificar token de API do Jira
SolidAffiliate
Integração do programa de afiliados.
| Campo | O que exibe |
|---|---|
| Status do Plugin | Ativo (verde) ou Não Encontrado (vermelho) |
| Afiliados | Contagem total de afiliados |
| Aprovações Pendentes | Afiliados aguardando análise |
Ações:
- Abrir SolidAffiliate -- link para o painel admin do SolidAffiliate
Cloudflare
Workers, banco de dados D1 e armazenamento R2 para o portal MIDDAG App.
| Campo | O que exibe |
|---|---|
| Status | Indicador de saúde |
| Workers | Status do deploy de Workers ativo |
| Banco de Dados D1 | Status da conexão com o banco de dados |
| Armazenamento R2 | Status do bucket de armazenamento |
Ações:
- Testar Conexão -- verificar token de API do Cloudflare
Verificação de saúde
No topo do painel de Integrações, um botão Executar Todas as Verificações de Saúde testa todas as integrações simultaneamente e atualiza todos os indicadores de status. O botão exibe um spinner enquanto as verificações estão em andamento. Os resultados são atualizados em tempo real conforme cada verificação é concluída.
Páginas relacionadas
- Configurações -- configuração de credenciais de integrações
- Faturas -- processamento de pagamentos Stripe e emissão de NFSe
- Afiliados -- dados de parceiros SolidAffiliate
- Orçamentos -- sincronização de orçamentos do HubSpot
- Dashboard -- alertas de integrações aparecem nos itens de ação