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.