Integração: Como enviar e consultar dados na Dito via API e BigQuery

Criada por Amanda Ribas, Modificado em Sex, 8 Mai na (o) 1:15 PM por Thayane Peres

Na Dito CRM, enquanto nossa API é o canal ideal para você nos enviar dados com agilidade, o BigQuery é a ferramenta que devolve o poder de análise, permitindo extrair e cruzar informações estratégicas com total liberdade. Neste material vamos abordar um pouco sobre essas opções e como solicitar acesso a nossa equipe.



  • Nível de Acesso: Administrador e Desenvolvedor.
    Persona: Analista de E-commerce, Desenvolvedor.




API Pública

A Dito possui uma API pública que permite o envio de cadastros e comportamentos de consumidores para a plataforma. Ela serve para integrar dados de origens externas, eventos de carrinho abandonado em plataformas (caso não possuam Vtex), garantindo a centralização das informações.


O que você faz através da nossa API?

Para que a segmentação no CRM seja precisa, a API foca em dois pilares fundamentais:

  • Identificação (Quem é o cliente?): Envio e atualização do cadastro completo do consumidor (nome, e-mail, telefone, preferências e tags personalizadas). Isso garante que você sempre tenha a ficha do cliente atualizada.

  • Track (O que o cliente faz?): Registro de comportamentos e eventos em tempo real. Seja uma compra realizada, um produto visualizado no site ou um abandono de carrinho, cada passo do cliente é enviado para que você possa agir sobre ele.


Você pode ter acesso a nossa documentação oficial clicando aqui, nela irão constar informações de como:


Uma das formas mais comuns de utilizar nossa API de envio é integrando-a às suas Landing Pages de campanha. Quando um visitante preenche um formulário para baixar um material ou receber um cupom, a API da Dito trabalha nos bastidores para:

  • Criar a ficha: O nome, e-mail e telefone capturados no formulário são enviados instantaneamente para criar ou atualizar o cadastro desse consumidor na base da Dito.


Importante: para ter acesso você precisa solicitar via suporte, onde será criada uma SA (service account) para o solicitante.



A nossa API pública foi desenhada para garantir que nenhum dado de comportamento seja perdido, funcionando como um fluxo contínuo de entrada.



BigQuery Dito: Transformando dados em inteligência

Se você utiliza a nossa API, sabe que ela é uma excelente ferramenta para enviar informações para a Dito (como transações, eventos e características dos seus clientes). Porém, para que sua estratégia seja completa, você também precisa de uma forma potente de extrair e analisar esses dados.


É aqui que entra o BigQuery.


O que é o BigQuery?

O BigQuery é o local onde guardamos todas as informações que você nos envia, de forma organizada, segura e pronta para ser consultada em alta velocidade.


Para que ele serve?

Diferente da nossa API atual (que é focada em receber dados), o BigQuery é a ferramenta que permite que você leia e cruze essas informações. Com ele, você pode:

  • Criar relatórios personalizados: Vá além dos dashboards padrão e crie suas próprias métricas.
  • Exportar dados brutos: Leve suas segmentações e históricos de eventos para outras ferramentas (como Power BI, Tableau ou planilhas).
  • Análises Profundas: Entenda o comportamento do seu cliente cruzando dados de diferentes períodos e campanhas com total liberdade.


Por que eu preciso dele se já tenho a API?

Hoje, a API da Dito funciona como uma "via de mão única": ela serve para alimentar a plataforma com os dados do seu negócio. O BigQuery é a via de volta. Ele é o caminho oficial para que você tenha acesso total aos dados de segmentação e relatórios que você vê na nossa interface, permitindo manipulações complexas que uma API comum não suporta.


Importante: O acesso ao BigQuery é um serviço opcional e possui um custo adicional caso não esteja presente em contrato. Solicite mais informações via Suporte.




FAQ – Perguntas Frequentes

1. Pergunta: O que é possível enviar através da API pública da Dito?
Resposta: É possível realizar o envio do cadastro de um consumidor e enviar os comportamentos desse consumidor.


2. Pergunta: Em quais situações de uso a API é indicada?
Resposta: A API é para envio de eventos e características, como por exemplo, dados coletados em uma Landing Page ou eventos de abandonou carrinho para quem não é cliente Vtex.


3. Pergunta: Como obter acesso ao BigQuery para extrair informações específicas?
Resposta: Basta abrir um chamado via chat, para liberar o acesso para o seu usuario.


4. Pergunta: A API pode ser usada para quem não utiliza a plataforma Vtex?
Resposta: Sim, se o usuário quer criar o evento de abandonou carrinho mas não é cliente Vtex, ele pode configurar o evento e fazer o envio via API.




Ficou com alguma dúvida ou identificou algum problema? Acione nosso time pelo chat disponível no app dito. (Horário de Atendimento de Segunda a Sexta das 9hrs as 18hrs)



TAGS: API Dito, BigQuery Dito, integração de dados, enviar dados Dito, consultar dados Dito, exportar dados Dito, API pública, service account, relatórios personalizados, abandono de carrinho, landing pages, webhook, eventos, track, Vtex. PERGUNTAS: Como integro meu sistema com a Dito? Posso enviar dados de landing page para a Dito? Como extrair relatórios da Dito? O que é o BigQuery da Dito? Preciso da Vtex para usar a API da Dito? Como consultar dados na Dito? Como usar a API da Dito?

Este artigo foi útil?

Que bom!

Obrigado pelo seu feedback

Desculpe! Não conseguimos ajudar você

Obrigado pelo seu feedback

Deixe-nos saber como podemos melhorar este artigo!

Selecione pelo menos um dos motivos
A verificação do CAPTCHA é obrigatória.

Feedback enviado

Agradecemos seu esforço e tentaremos corrigir o artigo