Desconectar integração

Em algum momento você pode precisar desconectar uma integração — trocar de conta Meta, parar de usar Lead Ads, mudar instância WhatsApp. O Syncro tem padrões diferentes de desconexão por integração: algumas fazem soft delete (mantém dados, marca status), outras hard delete (limpa). Esse artigo cobre o comportamento de cada uma.

Pré-requisitos

• Permissão admin pra desconectar a maioria.
• Entender o que vai acontecer com dados existentes (cobertos abaixo por integração).

Caminho geral

1. Vá em Configurações → Integrações.
2. Encontre o card da integração desejada.
3. Botão Desconectar (varia por integração — pode estar no card ou em modal).
4. Confirme.

Por integração

Google Calendar

Soft delete:

1. Card Google Calendar → Desconectar Google.
2. Confirme.
3. Sistema:

• Atualiza OAuthConnection.status = 'revoked'.
• Não revoga token na Meta (cliente ainda vê app autorizado em myaccount.google.com).

4. Card vira Reconectar.

O que acontece com dados:

• ✅ Eventos do Google (source='google') mantidos no banco. Continuam visíveis.
• ✅ Eventos do Syncro (source='syncro') mantidos. Não são mais espelhados.
• ❌ Sync inbound + outbound param.

Pra reconectar:

• Clique em Conectar Google → novo OAuth.
• Sync retoma onde parou.

💡 Dica: pra revogar tokens completamente, vá em myaccount.google.com → Apps com acesso → Remover acesso.

Facebook Lead Ads

Soft delete:

1. Card Lead Ads → Desconectar Facebook.
2. Confirme.
3. Sistema:

• Marca OAuthConnection.status='revoked'.
• Marca todas FacebookLeadFormConnection.is_active = false.

4. Card vira Reconectar.

O que acontece:

• ✅ Leads já criados mantidos.
• ✅ Conexões de formulários preservadas (apenas inativas).
• ❌ Novos webhooks rejeitados — Meta vai tentar entregar mas Syncro retorna inativo.

Pra reconectar:

• Clique em Conectar Facebook → novo OAuth.
• Conexões antigas precisam ser reativadas individualmente (toggle no card de cada).

Instagram

Soft delete:

1. Card Instagram → Desconectar Instagram.
2. Confirme.
3. Sistema:

• Marca InstagramInstance.status='disconnected'.
• Apaga access_token (zera por segurança).

4. Card vira Reconectar.

O que acontece:

• ✅ Conversas WhatsApp/Instagram existentes mantidas. Histórico preservado.
• ✅ Leads vinculados mantidos.
• ❌ Novas DMs NÃO chegam ao CRM.
• ❌ Automações de comentário param.
• ❌ Novos webhooks Meta rejeitados.

Pra reconectar:

• Clique em Conectar Instagram → novo OAuth.
• Sistema reusa mesma instance — webhooks voltam.

WhatsApp via QR Code

Soft delete por instância (você pode ter várias):

1. Configurações → Integrações → card WhatsApp.
2. Encontre a instância específica.
3. Botão Desconectar.
4. Confirme.
5. Sistema:

• Marca WhatsappInstance.status='disconnected'.
• Para sessão (stopSession).
• Limpa phone_number e display_name.

O que acontece:

• ✅ Conversas mantidas no banco.
• ✅ Mensagens preservadas.
• ❌ Novas mensagens não chegam (sessão fechada).

Pra reconectar:

• Em Adicionar número → mesmo número via QR.
• Sistema reativa instance existente.

💡 Dica: excluir instância é diferente de desconectar — exclusão deleta dados associados (uso raro, só se quer limpar de vez).

WhatsApp Cloud API

Hard delete (com cleanup remoto):

1. Card Cloud API → instância → Desconectar.
2. Confirme.
3. Sistema:

• Tenta unsubscribe webhook na Meta (best-effort).
• Marca WhatsappInstance.status='disconnected'.
• Limpa system_user_token.

O que acontece:

• ✅ Conversas/mensagens mantidas.
• ✅ Templates HSM continuam APPROVED na Meta (mas sem instância vinculada, não dá pra usar).
• ❌ Novas mensagens não chegam.
• ❌ Templates HSM ficam órfãos — recrie quando reconectar.

Pra reconectar:

• Templates podem precisar resync ou recriar.

n8n

Não há desconexão pela página de integrações — n8n é info-only.

Pra desconectar:

1. Vá em n8n → Credentials → encontre "Syncro CRM API".
2. Delete.

E no Syncro, revogue API Key:

1. /configuracoes/api-keys.
2. Encontre key usada pelo n8n.
3. Revogar.

Workflows n8n que usavam essa key vão parar de funcionar.

ElevenLabs

Não há desconexão por tenant — ElevenLabs é configurada por agente IA individual.

Pra parar de usar:

1. Edite o agente IA.
2. Aba Voz.
3. Toggle Habilitar resposta em áudio = OFF.
4. Salve.

Agente volta a responder em texto.

Pra desativar globalmente (não disponível pro tenant), super_admin precisa remover env vars ELEVENLABS_API_KEY.

Comparativo soft vs hard delete

Antes de desconectar — checklist

• Comunique equipe (atendentes podem perder acesso a conversas que usam essa integração).
• Backup de dados importantes (exporte leads/conversas).
• Avise clientes se vai mudar canal de atendimento.
• Documente motivo (pra audit log e futuras decisões).
• Verifique automações que dependem da integração — atualize ou desative.
• Cheque webhooks apontando pra essa integração — atualize.

Reconexão

Pra reconectar após desconexão:

1. Card volta a mostrar Reconectar ou Conectar.
2. Clique e siga fluxo normal.
3. Sistema detecta integração existente e reusa onde possível.

Veja artigos individuais de conexão pra cada integração.

LGPD — direito ao esquecimento

Se cliente final pedir exclusão completa (LGPD):

1. Desconecte integração.
2. Anonimize/delete leads associados em /contatos.
3. Limpe conversas (botão excluir individual).
4. Logs de audit mantidos por 5 anos (obrigação fiscal/legal).

Erros comuns

"Botão desconectar não aparece"

• Você não tem permissão admin.
• Card já está desconectado.

"Desconectei mas mensagens continuam chegando por horas"

• Webhook Meta tem retry agressivo — pode levar até 72h pra parar de tentar.
• Mensagens já em fila são processadas até zerar.

"Reconectei mas dados antigos sumiram"

• Hard delete apagou (Cloud API templates órfãos, etc).
• Verifique soft vs hard na tabela acima.

"Quero desconectar mas tem subscription ativa"

assinatura/ é independente das outras integrações. Você cancela billing separadamente em /configuracoes/cobranca.

"Não consigo deletar instância — diz que tem conversas vinculadas"

Soft delete (desconectar) não exige limpar conversas. Apenas excluir definitivo exige.

Próximos passos

• Pra entender cada integração específica, veja artigos individuais.
• Pra LGPD em detalhe, veja Excluir conta.

Artigos relacionados

• checkout

• Google Calendar

• Facebook Lead Ads

• Instagram OAuth

• Excluir conta