A Dito é um CRM/CDP de varejo: sua marca envia eventos de loja física e de e-commerce para a Dito, que unifica tudo numa ficha por consumidor e opera cashback em cima dessa base. A conexão com a Toca usa uma Service Account (e-mail e senha) mais o rótulo da marca — os três são criados pelo atendimento da Dito, não por autocadastro.

Esta integração está em homologação: a conexão funciona normalmente, mas as consultas no chat ainda estão em validação.

Antes de começar

• Peça ao atendimento da Dito uma Service Account de integração: um e-mail corporativo não nominal (ex.: integracao@suamarca.com.br) com senha. O login pessoal do painel da Dito não funciona aqui.
• Peça também o rótulo da marca (brand), que identifica sua marca nas consultas.
• Informe à Dito quais rotas você vai usar: a autorização é concedida por endpoint, e sem essa liberação a conta autentica mas não lê nada. Para a Toca, peça a liberação da ficha do consumidor (GetProfile) e, se a marca usa cashback, do saldo e do histórico de cashback.
• O módulo de Cashback é contratado à parte na Dito. Sem ele, a integração cobre apenas a ficha do consumidor.

Passo a passo

1. Acesse Configurações → Integrações na Toca.
2. Localize o card Dito e clique em Conectar.
3. Preencha os três campos:
   • E-mail da Service Account — o e-mail corporativo emitido pela Dito.
   • Senha da Service Account.
   • Rótulo da marca (brand) — exatamente como informado pela Dito.
4. Salve. O card fica marcado como conectado.

O que a Toca acessa

Com a conexão ativa, a Toca lê a ficha do consumidor (contato, endereço e dados próprios da marca), o saldo e o histórico de cashback por cliente — com campanha, validade e status de cada crédito — e os pedidos de exclusão de consumidor (LGPD).

Toda consulta é feita por um consumidor identificado: a API da Dito não oferece listagem de clientes nem busca por e-mail ou CPF. A integração aprofunda um cliente que você já conhece; ela não produz recortes da base. É somente leitura: a Toca não altera nada no seu CRM.

Manutenção da conexão

As credenciais da Service Account não expiram sozinhas. O token temporário que a Dito emite a cada sessão vale 24 horas e é renovado automaticamente pela Toca, sem ação sua. A conexão permanece ativa até a senha ser trocada ou a conta ser desativada pela Dito — nesses casos, atualize os dados no card. Por segurança, a senha salva não é exibida de volta.

Problemas comuns

• Autentica, mas toda consulta volta com acesso negado — a rota não foi liberada para a Service Account. A autorização da Dito é por endpoint: peça ao atendimento a liberação da rota que falta. Reconectar não resolve, porque a credencial está viva.
• Erros apenas nas consultas de cashback — a marca não tem o módulo de Cashback contratado na Dito. Sem ele, a integração responde só pela ficha do consumidor.
• Falha de autenticação ao salvar — confira e-mail e senha. Precisa ser a Service Account emitida pela Dito, não o seu login pessoal do painel.
• Consumidor não encontrado — confirme com a Dito se o rótulo da marca informado é exatamente o cadastrado para a sua operação.