Acesse a página de “Criar conta” do Módulo Bots. Insira seus dados, lembrando que os campos marcados com * são de preenchimento obrigatório. Após inserir os dados, marque a caixa “Não sou um robô” e clique em “Criar”. Uma mensagem de confirmação da criação da conta será exibida, conforme a imagem abaixo: Em seguida, acesse o e-mail inserido no cadastro, localize o e-mail de confirmação e clique em “Confirmar”. Obs: Caso não encontre o e-mail na caixa de entrada, verifique a caixa de Spam. Confirme novamente na tela de confirmação de usuário que será aberta no navegador, e sua conta estará pronta para uso!

Os blocos de mídia servem para enviar ou receber arquivos durante o fluxo do bot, como imagens, vídeos, áudios, documentos ou arquivos dinâmicos por URL. Eles ficam agrupados na seção MÍDIA E ANEXO do menu lateral. Esse FAQ resume quando usar cada bloco e os cuidados básicos. Onde encontrar os blocos de mídia Todos os blocos de mídia estão no menu lateral do criador, dentro do grupo MÍDIA E ANEXO. Também é possível encontrá-los usando a busca pelo nome do bloco. Mídia Dinâmica Use quando o arquivo precisa ser enviado a partir de uma URL, fixa ou vinda de uma variável. O bloco envia o arquivo definido no campo de URL durante a execução do fluxo. A URL deve apontar diretamente para um arquivo publicado. Não é possível usar links do YouTube. É possível configurar tempo de digitação, tags, checkpoint e acesso rápido. Coleta de arquivos Use quando o bot precisa receber arquivos do usuário. O usuário pode enviar arquivos de acordo com os tipos permitidos na configuração. O nome ou a URL do arquivo pode ser salvo em uma variável. Esse bloco exige integração com o Google Storage para funcionar corretamente. Alertas em vermelho indicam configurações obrigatórias. Alertas em amarelo indicam campos vazios, mas não bloqueiam o fluxo. Imagem Use para exibir uma imagem no fluxo. A imagem pode ser enviada por upload ou por URL. O arquivo precisa estar publicado e não pode ultrapassar 15 MB. Links do YouTube não são aceitos. É possível configurar título da imagem e texto alternativo para acessibilidade. Vídeo Use para exibir um vídeo diretamente no fluxo. O vídeo pode ser enviado por upload ou por URL de arquivo publicado. O limite é de 15 MB. Vídeos do YouTube não são compatíveis com esse bloco. Áudio Use para enviar um arquivo de áudio ao usuário. O áudio pode ser enviado por upload ou por URL. O arquivo deve estar publicado e ter até 15 MB. Links do YouTube não são aceitos. Documento Use para enviar arquivos como PDFs, planilhas ou outros documentos. O documento pode ser enviado por upload ou por URL. O arquivo precisa estar publicado e ter até 15 MB. Links do YouTube não são compatíveis. Pontos importantes para todos os blocos de mídia O campo de URL não pode ficar vazio quando utilizado. As URLs devem apontar diretamente para arquivos publicados. Links do YouTube não funcionam em blocos de mídia. Para configurações avançadas e detalhes técnicos, consulte a documentação completa do produto.

O bloco Script permite adicionar lógica ao fluxo do bot, tornando o comportamento mais flexível e personalizado. Ele é usado quando você precisa manipular variáveis, aplicar regras simples ou tratar dados durante a conversa. Onde encontrar o bloco O bloco Script fica no menu lateral esquerdo, na seção Programação. Como configurar Após inserir o bloco no fluxo, clique em Editar script para abrir o editor. Dentro dele, você pode escrever o código que será executado quando o fluxo passar por esse bloco. O que é possível fazer com o Script Com o bloco Script, você pode: Usar e atualizar variáveis do fluxo Criar validações e cálculos simples Manipular informações antes de seguir no fluxo Adicionar tags automaticamente Estrutura básica Todo script precisa finalizar com a função done(). É ela que retorna o resultado da execução para o fluxo. Normalmente, o script pode: Enviar mensagens para o usuário Atualizar variáveis Inserir tags no fluxo Pontos importantes Se o bloco não tiver um script configurado, ele exibirá um alerta. Se o script não tiver finalização com done(), o bloco não será executado corretamente. Boas práticas Para chamadas de API, prefira usar o bloco APIv2. Use o bloco Script principalmente para tratar dados, aplicar regras e organizar informações.

O bloco Card no Digital Contact Bots permite apresentar uma mensagem visual com imagem, texto e botões interativos. Esses botões permitem que o usuário execute ações por clique, como abrir um link, copiar um conteúdo ou ser direcionado para outro bloco do fluxo. Onde encontrar o bloco O bloco Card está disponível no menu lateral, dentro da seção Texto e Menu. Após inseri-lo no fluxo, ele aparecerá no criador pronto para configuração. Campos principais do bloco Card O bloco Card possui campos específicos que definem sua aparência e interação. É possível adicionar uma imagem selecionada do computador ou informar a URL de uma imagem, que pode ser fixa ou vinda de uma variável, sendo carregada apenas no momento da execução. O título do card é obrigatório e aceita até 500 caracteres, enquanto a descrição é um texto curto exibido junto ao card, com limite de 60 caracteres. O card também permite configurar botões, podendo ser um único botão de URL ou até três botões dos tipos URL, Bloco ou Copiar. O texto dos botões pode ser fixo ou dinâmico, com limite de 20 caracteres por botão. Como funcionam os botões Botão URLAbre um link em uma nova aba. Botão CopiarCopia o conteúdo configurado para a área de transferência do usuário. Botão BlocoDireciona o fluxo para outro bloco definido na configuração do botão. Funcionamento do fluxo Quando o card não possui botões configurados e a opção de salvar variável está desligada, o fluxo segue automaticamente. Quando o card não possui botões, mas a opção de salvar variável está ligada, o bloco aguarda uma mensagem do usuário. Quando existe um botão configurado para direcionamento de bloco, o sistema aguarda a ação do usuário, independentemente da opção de salvar variável estar ligada ou não. Quando existem apenas botões de URL ou Copiar, o bloco só aguarda o usuário se a opção de salvar variável estiver ligada. O clique em botões de URL ou Copiar não continua o fluxo automaticamente. Se o bloco estiver aguardando, o fluxo só seguirá após o usuário enviar uma mensagem de texto. Se um botão de direcionamento de bloco for configurado sem um bloco de destino, ao clicar no botão o fluxo será encerrado. Comportamento específico no WhatsApp Quando o card usa a opção de único botão, o campo de descrição não será exibido. Se houver um botão do tipo Copiar, será exibido um aviso informando que esse botão não aparece no WhatsApp. No WhatsApp é obrigatório que o card tenha pelo menos um botão configurado. Caso contrário, o sistema adiciona automaticamente um botão “Ok”. Visualização final Após configurar o bloco, o card será exibido de forma diferente dependendo do canal. No Webchat, o card exibirá imagem, título, descrição e botões conforme configurado. No WhatsApp, o card será adaptado às regras do canal, respeitando as limitações de botões e campos disponíveis.

O bloco Mensagem Customizada funciona de forma parecida com um bloco de script. A principal diferença é que, ao final da execução, ele gera um único payload, que será enviado diretamente para o canal escolhido. Isso significa que você precisa montar o payload exatamente no formato aceito pelo canal de envio. Estrutura básica do bloco Dentro do editor, você escreve um script que monta o objeto de mensagem e finaliza com a função done(). Exemplo de criação manual de um card para WhatsApp: A chamada done(body) é obrigatória. Ela indica que o payload está pronto para ser enviado. O que é possível fazer com esse bloco Com a Mensagem Customizada, você pode: Criar um payload totalmente alinhado à regra de negócio do seu canal Usar variáveis globais ou do fluxo dentro do JSON Utilizar lógica e funções para montar o conteúdo dinamicamente Diferença de uso por canal O formato do body muda de acordo com o canal onde a mensagem será enviada. WhatsApp No WhatsApp, o body deve seguir exatamente o padrão de mensagens definido na documentação oficial do canal. Para esse bloco, o payload deve conter apenas uma mensagem, e não uma lista de mensagens, mesmo que a documentação permita listas. Também é recomendado usar IDs únicos em mensagens customizadas. Isso evita problemas no recebimento dos status de entrega. Recursos de callback dinâmicos não são compatíveis com esse bloco. Webchat No Webchat, o body pode ser bem mais simples. Você pode enviar diretamente: Uma string de texto Ou um conteúdo em HTML que será renderizado no chat Onde encontrar o bloco no Digital Contact Bots O bloco Mensagem Customizada fica no menu lateral esquerdo, dentro da seção Programação. Após adicionar o bloco ao fluxo, ele aparecerá visualmente no editor e poderá ser configurado. Configurações do bloco O bloco possui duas configurações principais. Editar mensagem Abre um editor semelhante ao editor de script, mas com um template próprio para mensagens customizadas. Nesse editor, você encontra: Adicionar variáveis Permite inserir variáveis globais ou variáveis do fluxo diretamente no código. Carregar templates Insere um código inicial no editor. Esse botão só funciona quando o editor está vazio. Armazenamento de resposta Essa opção permite que o bloco aguarde a resposta do usuário após o envio da mensagem. A resposta será salva em uma variável, funcionando da mesma forma que no bloco de texto, porém sem a opção de validação.