O External Sync, ou BYOD (Bring Your Own Database), permite manter uma cópia dos resultados do seu bot em provedores externos, para que você tenha controle total sobre os seus dados.

​
O que é o External Sync?

Por padrão, o Sendbot armazena todos os resultados das conversas no banco interno. Com o External Sync, você pode replicar automaticamente esses dados para:
  • Supabase - A serverless PostgreSQL database
  • Google Sheets - Google spreadsheets
  • NocoDB - An open-source Airtable-style database
  • Webhooks - Any HTTP endpoint for custom integrations

​
Por que usar?

Data Ownership

Your data stays in your own database, not only in Sendbot’s cloud.

Integrations

Connect directly to your CRM, ERP, or BI stack without extra middleware.

Automatic Backup

Real-time redundancy for every result.

Custom Analytics

Use SQL or BI tools to run advanced analytics on your data.

​
Como configurar a sincronização

​
1. Abra as configurações do bot

No editor, clique em “Results” -> “Storage” para abrir as configurações de armazenamento.

​
2. Escolha um provedor

Selecione um dos provedores disponíveis:
Requirements:
  • A Supabase project
  • An API key (anon or service_role)
  • Your project URL
  • A destination table name
Table setup:Your table should include a result_id column (text, unique) to prevent duplicates:

​
3. Configure o mapeamento de colunas

Defina como as variáveis do seu bot se conectam às colunas de destino:

​
4. Opções avançadas

​
boolean
padrão:"true"
Também sincroniza dados como horário de início, conclusão e origem da sessão.
​
array
Restringe a sincronização a sessões originadas apenas de domínios específicos.

​
Arquitetura técnica

O sistema usa uma arquitetura de Outbox Pattern para garantir confiabilidade:

​
Garantias de confiabilidade

  • Criptografia em repouso: os payloads são criptografados antes de entrar na fila
  • Retries automáticos: exponential backoff em caso de falha
  • TTL configurável: os registros expiram em 72h por padrão (RESULTS_SYNC_OUTBOX_TTL_HOURS)
  • Idempotência: o versionamento incremental evita duplicidades

​
Monitoramento

Na aba “Storage” em Results, você consegue ver:
  • status da sincronização por resultado
  • erros recentes e quantidade de retries
  • última sincronização bem-sucedida
Se você vir erros 401 ou 403, verifique se as credenciais do provedor estão corretas e ainda são válidas.

​
Variáveis de ambiente

Em deploys self-hosted, você pode configurar:

​
Próximos passos

Credentials

Aprenda a configurar credenciais para cada provedor.