--- title: "Template com variável no CTA (Botão de Call-to-Action)" description: "Veja como utilizar variável no Call-to-Action (CTA) de botões em mensagens do WhatsApp na plataforma Duotalk." url: https://ajuda.duotalk.io/pt/articles/161-template-com-variavel-no-cta-botao-de-call-to-action collection: "Mensagem Template" updated: 2026-10-21 language: pt --- # Template com variável no CTA (Botão de Call-to-Action) Veja como utilizar variável no Call-to-Action (CTA) de botões em mensagens do WhatsApp na plataforma Duotalk. Com essa funcionalidade, é possível inserir uma variável diretamente na URL do botão, permitindo a criação de links únicos e personalizados para cada destinatário. Isso é útil para cenários como envios de links de cadastro personalizados, rastreamento de conversões ou direcionamento individualizado. As variáveis são definidas usando a sintaxe {NOME\_DA\_VARIAVEL}, onde NOME\_DA\_VARIAVEL corresponde ao nome do parâmetro fornecido. Os valores das variáveis podem ser passados de duas formas principais: - **Via Body da requisição API**: No Body da requisição POST, como um objeto JSON. - **Via coluna de planilha**: Ao importar dados de uma planilha (ex.: Google Sheets ou Excel), onde cada coluna representa um parâmetro, lembrando que o arquivo deve ser um CSV, separado por vírgula. ## **Configurando o Botão com Variável** ![](https://staticfiles.gleap.io/ghelparticle/qW0JWORVdF71CMNasUdsEHG1rNBXtiw6LFNhY9Tp0W6MoJGdFpXkga1oXYATqjFthIP3FY79Quo.png) ### **Adicione um botão CTA ao cadastrar um Template:** - Na interface de configuração do template, vá para "Botões". - Selecione o tipo "CALL\_TO\_ACTION". ### **Adicione ou edite um botão**: - Defina o texto do botão (ex.: "Cadastre Agora!"). - No campo de URL, insira o link com a variável no formato {NOME\_DA\_VARIAVEL}. Exemplo: - [https://duotalk.com.br/?id\_cadastro={ID\_CADASTRO}](https://duotalk.com.br/?id_cadastro={ID_CADASTRO}) - Aqui, {ID\_CADASTRO} será substituído pelo valor fornecido para cada mensagem. - Se atente ao Case-sensitive (caixa alta ou caixa baixa da sua variável), é preciso estar idêntico em todos as menções da variável. ### **Limites e validações**: - O texto do botão tem um limite de 20 caracteres. - Variáveis podem ser usadas em qualquer parte da URL, como parâmetros de query. - Só é possível utilizar uma variável por URL. Em caso de ter mais de uma variável, envie uma variável única. - Não é possível utilizar somente variável no campo do link, é preciso ter o link com a url raiz e utilizar somente uma variável. - Certifique-se de que o nome da variável corresponda exatamente ao parâmetro passado (case-sensitive). ## **Utilizando Parâmetros via Body da Requisição API** Para envios programáticos, use a API do Duotalk para enviar mensagens com variáveis resolvidas. ### **Endpoint da API**: - Método: POST - URL exemplo - gerar url Webhook do template correspondente. [ Envio de Webhook (Mensagem Template) Como enviar mensagens para o WhatsApp de seus contatos através de outros sistemas ](https://ajuda.duotalk.io/pt/articles/26-envio-de-webhook-mensagem-template.md) ### **Estrutura do Body**: - Formato: JSON (selecione "raw" e "JSON" na ferramenta de teste, como Postman). - Inclua os campos obrigatórios (ex.: name, phone) e os parâmetros das variáveis. - Exemplo de Body: ```javascript { "name": "Nome do Contato", "phone": "5511999999999", "ID_CADASTRO": "556677" } ``` - name: Nome do destinatário. - phone: Número de telefone no formato E.164 (sem pontos ou hifens). - ID\_CADASTRO: Valor da variável que será inserido na URL. ### **Como funciona a substituição**: - Ao enviar a requisição, o sistema substitui {ID\_CADASTRO} pelo valor "556677", gerando uma URL única: [https://duotalk.com.br/?id\_cadastro=556677](https://duotalk.com.br/?id_cadastro=556677). - Isso permite envios em massa com personalização, como em automações ou integrações com CRMs. ## **Passando Parâmetros via Coluna de Planilha** Para envios em lote via importação de dados. ### **Prepare a planilha**: - Crie colunas para os campos obrigatórios e variáveis. - Exemplo de estrutura (em formato de tabela):

name

phone

email

ID_CADASTRO

Nome do Contato

551199999999

556677

- name: Nome. - phone: Número de telefone (pode ser formatado como científico, mas será convertido). - ID\_CADASTRO: Coluna com o valor da variável. ### **Importe a planilha na campanha**: - Na interface do Duotalk, importe o arquivo em CSV, separado por vírgula. - Mapeie as colunas para os campos correspondentes. - O sistema usará os valores de cada linha para substituir variáveis nas URLs. ### **Envio em massa**: - Cada linha da planilha gera uma mensagem personalizada. - Exemplo: Para a linha acima, a URL do botão será [https://duotalk.com.br/?id\_cadastro=556677](https://duotalk.com.br/?id_cadastro=556677). ## **Exemplos de Uso** - **Personalização de cadastro**: Envie links únicos com IDs de rastreamento para medir conversões. - **Campanhas promocionais**: Inclua códigos de desconto variáveis como {CODIGO\_DESCONTO}. - **Integração com e-commerce**: Passe IDs de pedidos para links de status. ## **Dicas e Melhores Práticas** - **Testes**: Sempre teste com um pequeno conjunto de dados para verificar a substituição. - **Erros comuns**: - Nome da variável não corresponde ao parâmetro (ex.: {id\_cadastro} é diferente de {ID\_CADASTRO}. - Formato de telefone inválido, causando falha no envio. - Limite de caracteres excedido no texto do botão. - **Limitações**: Só é possível utilizar uma variável no corpo da URL. Para mais detalhes ou suporte, consulte a documentação completa da API no site do Duotalk ou contate o suporte técnico.