Como transferir variáveis ​​personalizadas durante uma inscrição para um chatbot

A integração da SendPulse com aplicativos de mensagem permite transferir variáveis personalizadas para a sua conta na SendPulse quando um usuário assina o seu chatbot por meio de um widget no site ou de um link do chatbot. Use esse recurso para atualizar automaticamente os valores de variáveis no seu Público do chatbot.

Você também pode enviar tags UTM durante uma assinatura. O Público do chatbot salva os valores de UTM de cada assinante em variáveis.

Assinatura por chat ao vivo ou widget

O código JavaScript em chats ao vivo e widgets de assinatura pode detectar e salvar automaticamente tags UTM.

Quando um usuário acessa seu site por meio de um link com tags UTM, formatadas com? e &, essas tags são automaticamente salvas nos dados de contato desse usuário assim que ele assina.

Para transferir mais tags ou variáveis personalizadas, use um dos dois métodos descritos abaixo.

Método 1. Usando o script window.oSpP

Depois de criar um chat ao vivo ou widget de assinatura, você pode usar um script para transferir automaticamente variáveis durante uma assinatura de chatbot. O código ficará assim:

<script type="text/javascript">
    window.oSpP = {
        phone: '+123123123',
        email: 'username@example.com',
        name: "Annabelle",
        city: "London"
    }
</script>

Imagine que o seu site, vinculado a um chatbot, receba os dados de um visitante, como nome, cidade, e-mail ou telefone. Se esse visitante assinar seu chatbot, os dados serão recebidos e salvos como variáveis.

Se um cliente assinar o seu chatbot antes que as variáveis de telefone, e-mail, cidade e nome sejam adicionadas, os dados não serão salvos na sua conta da SendPulse.

Você pode exibir automaticamente os nomes dos assinantes em conversas transferindo-os a partir do chat ao vivo. Para isso, use o parâmetro window.oSpP.full_name no seu script:

<script> window.oSpP = { full_name: "Anabelle Cane", city: "London" } </script>

Os contatos aparecerão imediatamente com os nomes especificados em Conversas e no Público do chatbot.

Se você coletar variáveis adicionais de assinantes de web push usando window.oSpP, isso pode interferir no widget de coleta de variáveis do chatbot, fazendo com que ele não funcione corretamente. Para evitar isso, utilize o método alternativo.

Método 2. Usando campos de entrada ocultos

Esse método se aplica a widgets de assinatura.

Adicione campos extras com a classe sp_push_custom_data no seu site:

<input type="hidden" name="email" class="sp_push_custom_data " value="username@example.com">
<input type="hidden" name="phone" class="sp_push_custom_data " value="+123123123">
<input type="hidden" name="name" class="sp_push_custom_data " value="Annabel">
<input type="hidden" name="city" class="sp_push_custom_data " value="London">

Ambos os métodos podem ser usados em sites que rodam em qualquer CMS.

Assinatura por link

Também é possível transferir variáveis durante uma assinatura adicionando-as ao link do chatbot com os delimitadores listados abaixo. Todos os parâmetros dos exemplos são opcionais.

Esse método ajuda a transferir tags UTM, endereços de e-mail, números de telefone ou quaisquer outras variáveis personalizadas. Quando um usuário clica no link e inicia uma conversa, os valores das variáveis são automaticamente salvos no perfil desse assinante no público do chatbot.

Você pode copiar um exemplo de link para cada aplicativo de mensagem. Saiba mais: Como iniciar um bot por meio de um link ou código QR.

Nos links do chatbot do Telegram, adicione o domínio intermediário tg.pulse.is, pois o Telegram limita o formato e o tamanho dos dados transferidos. Seu link ficará assim:

https://tg.pulse.is/{bot_name}?start={flow_id}&var1_name=value1&var2_name=value2&utm_campaign=summer_sale&utm_medium=banner

Aqui, {bot_name} é o nome do seu chatbot no Telegram, {flow_id} é o ID do fluxo a ser disparado, var_name é o nome da variável no seu público do chatbot, value é o valor a ser transferido, e utm_campaign e utm_medium são parâmetros UTM opcionais.

Os links do chatbot do WhatsApp incluem o domínio intermediário  wa.pulse.is. O fluxo somente será iniciado quando o usuário enviar uma mensagem predefinida, como “Start” (Iniciar) ou outra que você configurar. Seu link ficará assim:

https://wa.pulse.is/{bot_owner_phone_number}?start={chain_id}&text=Start&var1_name=value1&var2_name=value2&utm_campaign=summer_sale&utm_medium=banner

O parâmetro text= é obrigatório. Seu link não funcionará sem ele.

Um link de chatbot do Facebook que transfere variáveis adicionais ficará dessa forma:

https://wa.pulse.is/{bot_phone}?text=Start&start=flow_id&var1_name=value1&var2_name=value2&utm_campaign=summer_sale&utm_medium=banner

Um link de chatbot do Instagram que transfere variáveis adicionais ficará assim:

https://m.me/{page_id}?ref={flow_id}__var1_name=value1__var2_name=value2__utm_campaign=summer_sale__utm_medium=banner

Links de chatbot do Viber só funcionam em dispositivos com o aplicativo instalado. Seu link ficará assim:

viber://pa?chatURI={bot_name}&context={flow_id}|var1_name=value1|var2_name=value2|utm_source=summer_sale|utm_medium=banner

Assinatura por formulário no site

Redirecione os usuários para o seu chatbot depois que eles preencherem o formulário no site desenvolvido com a SendPulse e envie os dados para o público do chatbot.

Vá até o seu chatbot, clique nos três pontos e copie o link do fluxo. Use esse link nas configurações do seu formulário.

Última Atualização: 16.12.2025