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:
const MESSAGE = "It's now $$global.hour$$";
const body = {
"message": "$$global.session$$" + MESSAGE,
"idmedia": "68c06e6d0321773cf2d1b2fe",
"cta": [
{
"text": "Entrar no X",
"id": 1,
"url": "https://x.com/home"
}
]
};
done(body);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.
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.