> ## Documentation Index
> Fetch the complete documentation index at: https://help.treble.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Blocos de Mensagem - Botões, Lista Interativa, Simples e com Opções

> Os blocos de mensagem são usados como a base fundamental para criar fluxos de conversação no Treble.ai. Estes são usados para mostrar informações, fazer perguntas, receber respostas e mais. Aprenda a usar os blocos de mensagem para criar fluxos de conversação personalizados.

<img src="https://mintcdn.com/trebleai/woBrUvSBPp-ldiW5/images/message-blocks-1.png?fit=max&auto=format&n=woBrUvSBPp-ldiW5&q=85&s=adef07e943285f4f6e078a38354ddcb8" alt="Blocos de mensagem" width="2388" height="1456" data-path="images/message-blocks-1.png" />

## Introdução

O Treble é uma ferramenta poderosa que permite projetar fluxos de conversação personalizados para seus clientes. Estes fluxos são construídos usando blocos de mensagem, que são fundamentais para mostrar informações, formular perguntas, receber respostas e mais. Ao projetar um fluxo de conversação, você está programando as interações que seu cliente terá com seu bot, similar a uma árvore de decisão.

<Note>
  É importante lembrar que no Treble existem dois tipos de fluxos de conversação:

  * **Fluxos de conversação inbound**: São aqueles com os quais seus clientes interagem ao enviar uma mensagem para seu número de WhatsApp.
  * **Fluxos de conversação outbound**: São aqueles que se iniciam quando sua empresa entra em contato com os clientes. Estes fluxos sempre devem começar com um template de mensagem (HSM) pré-aprovado pela Meta.
</Note>

Ao dominar o uso dos blocos de mensagem, você poderá criar fluxos de conversação efetivos e personalizados que melhorem a experiência do cliente e otimizem a comunicação. Para isso, é fundamental entender como funcionam os blocos de mensagem e como podem ser usados para criar fluxos de conversação personalizados.

## Onde encontro os blocos de mensagem?

Os blocos de mensagem se encontram na seção de **Blocos** do editor de fluxos de conversação no Treble. Para acessar esta visualização, siga os seguintes passos:

1. Desde a visualização principal de **Conversas**, clique no botão **Criar nova conversa**.
2. Depois, clique no botão <Icon icon="square-plus" iconType="solid" /> no painel superior, localizado à esquerda, para mostrar o menu de blocos.
3. Selecione o bloco de mensagem que deseja adicionar ao seu fluxo de conversação e clique no bloco para adicioná-lo ao seu fluxo de conversação.

<img src="https://mintcdn.com/trebleai/woBrUvSBPp-ldiW5/images/message-blocks-2.gif?s=a80714c5a77b5c62c795409e1df32971" alt="Blocos de mensagem" width="2380" height="1454" data-path="images/message-blocks-2.gif" />

### Estrutura de um bloco de mensagem

Antes de explicar como funciona cada bloco de mensagem, e seus diferentes tipos, é importante entender a estrutura de um bloco de mensagem.

<img src="https://mintcdn.com/trebleai/woBrUvSBPp-ldiW5/images/message-blocks-3.png?fit=max&auto=format&n=woBrUvSBPp-ldiW5&q=85&s=3e5790b0f7cd6d7c12c508cb715c169d" alt="Estrutura de um bloco de mensagem" width="2386" height="1454" data-path="images/message-blocks-3.png" />

A seguir, se explica em detalhes cada um dos elementos numerados na imagem anterior, para que você compreenda como configurar e aproveitar ao máximo os blocos de mensagem no Treble:

#### Ações rápidas do bloco

* <Icon icon="star" iconType="solid" /> **Bloco objetivo**: Permite configurar o bloco como um **Bloco objetivo**. Ao clicar na estrela, você pode definir metas mensuráveis para sua conversação. Isso é útil para campanhas onde você precisa medir conversões ou ações-chave.

  <Card title="Bloco objetivo" icon="star" href="/pt/docs/build-with-treble/guides/measure-links">
    Conheça mais sobre os blocos objetivos.
  </Card>

  * <Icon icon="arrow-right-arrow-left" iconType="solid" /> **Alterar bloco**: Altera o bloco atual por outro bloco de mensagem. Ao clicar no ícone, será mostrado um menu dropdown com os blocos de mensagem disponíveis.
  * <Icon icon="trash" iconType="solid" /> **Excluir bloco**: Remove o bloco de mensagem do fluxo. Útil para manter seu fluxo limpo e organizado.

#### Corpo da mensagem

* Aqui você escreve o texto principal que o usuário verá. Você pode personalizar a mensagem usando variáveis dinâmicas, emojis e links. Além disso, você pode anexar arquivos multimídia usando o botão <Icon icon="paperclip" iconType="solid" /> (ver ponto 3).

#### Anexar arquivos multimídia

* <Icon icon="paperclip" iconType="solid" /> Permite anexar imagens, documentos, vídeos ou localizações à mensagem. Isso enriquece a experiência do usuário e é ideal para mostrar produtos, enviar manuais ou compartilhar informações visuais.

  <Card title="Anexar arquivos multimídia" icon="paperclip" href="/pt/docs/build-with-treble/features/media">
    Conheça mais sobre como anexar arquivos multimídia em seus blocos de mensagem.
  </Card>

#### Opções de resposta do bloco

* Você pode adicionar botões de resposta rápida para que o usuário selecione uma opção. Isso facilita a navegação e a tomada de decisões dentro do fluxo conversacional. Os botões podem ser personalizados e você pode adicionar múltiplas opções. Você pode remover uma das opções clicando no botão <Icon icon="trash" iconType="solid" />.

  <Tip>
    As opções nos blocos de mensagem só estão disponíveis no bloco de mensagem **Botões Interativos**, **Lista Interativa** e **Mensagem com Opções**.
  </Tip>

  Você notará que cada opção adicionada tem um círculo branco <Icon icon="circle" iconType="solid" /> à direita. Este círculo é o que permite conectar esta opção com o bloco de mensagem que você deseja que seja mostrado quando o usuário selecionar esta opção. Para isso, clique no círculo, mantenha pressionado e arraste a seta até o bloco de mensagem que você deseja que seja mostrado quando o usuário selecionar esta opção.

  <img src="https://mintcdn.com/trebleai/woBrUvSBPp-ldiW5/images/message-blocks-4.gif?s=e31a7845674157baf90cee8793073d82" alt="Botões interativos" width="2384" height="1446" data-path="images/message-blocks-4.gif" />

#### Resposta não incluída em opções

* A opção **Resposta não incluída em opções** permite definir o que acontece se o usuário responder com uma mensagem que não corresponde a nenhum dos botões disponíveis. Você pode configurar redirecionar para outro bloco. É fundamental para lidar com respostas inesperadas e manter a conversação controlada.

  Casos de exemplo:

  * Se o usuário responder com uma mensagem que não corresponde a nenhum dos botões disponíveis, será redirecionado para o bloco de mensagem **Resposta não incluída em opções**.
  * Se o usuário enviar uma mensagem vazia ou apenas com espaços, pode ser configurado para receber uma mensagem de erro solicitando uma resposta válida.
  * No caso de o usuário enviar um emoji em vez de selecionar uma opção, o fluxo pode redirecioná-lo para um bloco que explique como interagir corretamente.
  * Se o usuário tentar enviar um arquivo anexado em vez de selecionar uma opção, pode ser redirecionado para um bloco que informe que os arquivos anexados não são aceitos neste contexto.

  Para usá-lo, clique no botão **Mensagem não incluída em opções**, ao clicar, se tornará uma opção de saída do bloco de mensagem que você pode conectar com outro bloco de mensagem. Para isso, clique no círculo <Icon icon="circle" iconType="solid" />, mantenha pressionado e arraste a seta até o bloco de mensagem que você deseja que seja mostrado quando o usuário selecionar esta opção.

  <img src="https://mintcdn.com/trebleai/woBrUvSBPp-ldiW5/images/message-blocks-5.gif?s=bad7d78f2bc2284ca8dbeecc6ede1b67" alt="Resposta não incluída em opções" width="2380" height="1444" data-path="images/message-blocks-5.gif" />

#### Fluxo alterno

* <Icon icon="shuffle" iconType="solid" /> Permite ativar o **Fluxo alterno**, uma funcionalidade avançada que redireciona automaticamente o usuário para outro bloco se ele não responder após um tempo predefinido. Isso é útil para manter a conversação ativa e evitar bloqueios por inatividade. Você pode configurar o tempo de espera e o destino do fluxo alterno.

  <Card title="Fluxo alterno" icon="shuffle" href="/pt/docs/build-with-treble/features/alternate-flow">
    Conheça mais sobre o fluxo alterno.
  </Card>

## Configuração avançada dos blocos de mensagem

<img src="https://mintcdn.com/trebleai/woBrUvSBPp-ldiW5/images/message-blocks-6.png?fit=max&auto=format&n=woBrUvSBPp-ldiW5&q=85&s=0bd2795fdff0984a5f8f54ee4dffd556" alt="Configuração avançada dos blocos de mensagem" width="2390" height="1456" data-path="images/message-blocks-6.png" />

Ao fazer duplo clique em qualquer bloco de mensagem, se abre o painel de **Configuração avançada** à esquerda do editor. Aqui você pode personalizar o comportamento do bloco com as seguintes opções:

* **Fluxo alterno**: Permite ativar o **fluxo alterno** para redirecionar automaticamente o usuário para outro bloco se ele não responder após um tempo predefinido. É útil para manter a conversação ativa e evitar bloqueios por inatividade.

  <Card title="Fluxo alterno" icon="shuffle" href="/pt/docs/build-with-treble/features/alternate-flow">
    Aprenda a configurar o fluxo alterno.
  </Card>

* **Temporizador e limite de mensagens**: **Só disponível para perguntas abertas (bloco de mensagem simples)**. Permite que o usuário responda em várias mensagens sem avançar até que se cumpra uma condição:
  * **Limite de mensagens**: A conversação avança quando o usuário envia a quantidade de mensagens configurada.
  * **Temporizador**: A conversação avança quando transcorre o tempo configurado desde a primeira mensagem do usuário. O temporizador não inicia até que o usuário envie sua primeira mensagem. **O temporizador não pode ser 0.**
  * Todas as mensagens enviadas pelo usuário são concatenadas em uma única resposta, separadas por quebra de linha. O sistema armazena a quantidade de mensagens em uma variável chamada <code>nome\_variável\_count</code> (por exemplo, <code>primeira\_resposta\_count</code>).
  * Exemplo: Se o usuário responder em duas mensagens:

    <pre>
      Olá
    </pre>

    e depois:

    <pre>
      Preciso de ajuda
    </pre>

    O sistema armazenará:

    <pre>
      Olá\nPreciso de ajuda
    </pre>

    e a variável <code>primeira\_resposta\_count</code> terá o valor 2.

* **Salvar resposta**: Permite armazenar a resposta do usuário em uma variável para usá-la posteriormente no fluxo. Você pode definir o nome e tipo de variável (texto, número, email, imagem, etc.).

  <Card title="Variáveis em blocos" icon="hashtag" href="/pt/docs/build-with-treble/features/variables">
    Aprenda a salvar respostas como variáveis.
  </Card>

* **Webhooks**: Permite ativar um webhook para enviar a resposta do usuário a um sistema externo em tempo real, facilitando integrações avançadas.

  <Card title="Webhooks" icon="link" href="/pt/api-reference/webhooks/intro">
    Aprenda a usar webhooks em seus blocos de mensagem.
  </Card>

* **Tentativa automática**: Se estiver ativado, o sistema tentará reenviar a mensagem automaticamente em caso de o usuário não responder em um tempo determinado. Para configurá-lo, ative o switch <Icon icon="toggle-on" iconType="solid" /> **Tentativa automática** depois de ter ativado a configuração avançada do bloco de mensagem. Você verá as seguintes opções:

  * **Mensagem da tentativa automática**: A mensagem que será mostrada ao usuário se ele não responder no tempo configurado.
  * **Tempo da tentativa automática**: O tempo em minutos que o sistema esperará para que o usuário responda.

## Blocos de mensagem

A seguir, se explicam os diferentes tipos de blocos de mensagem que você pode usar no Treble.

### Botões Interativos

<img src="https://mintcdn.com/trebleai/woBrUvSBPp-ldiW5/images/message-blocks-7.png?fit=max&auto=format&n=woBrUvSBPp-ldiW5&q=85&s=540a72ee9e37b20947213307669fc7c4" alt="Botões Interativos" width="2390" height="1450" data-path="images/message-blocks-7.png" />

Os blocos de mensagem **Botões Interativos** são usados para mostrar uma mensagem com botões de resposta. Estes botões podem ser personalizados e você pode adicionar até 3 opções. Esta funcionalidade de mostrar mensagens com botões no WhatsApp é exclusiva da WhatsApp Business API. As opções dos botões têm um limite de 20 caracteres.

### Lista Interativa

<img src="https://mintcdn.com/trebleai/woBrUvSBPp-ldiW5/images/message-blocks-9.gif?s=5d8c92cb9e11218de02fd2ed40db11b5" alt="Lista Interativa" width="1400" height="846" data-path="images/message-blocks-9.gif" />

Os blocos de mensagem **Lista Interativa** são usados para mostrar uma lista de opções de resposta. Estas opções podem ser personalizadas e você pode adicionar até 10 opções. Esta funcionalidade de mostrar mensagens com listas no WhatsApp é exclusiva da WhatsApp Business API. As opções da lista têm um limite de 20 caracteres.

Quando seu cliente receber uma mensagem com uma lista interativa, verá um botão com o texto da primeira opção da lista. Ao clicar no botão, se desdobrará uma lista de opções para que o usuário selecione uma.

### Mensagem com Opções

Os blocos de mensagem **Mensagem com Opções** são usados para mostrar uma mensagem com opções de resposta. Estas opções podem ser personalizadas e você pode adicionar opções ilimitadas. O Treble mostra esta mensagem como uma mensagem com o corpo da mensagem que você definiu, seguido com uma lista enumerada de opções.

Exemplo:
Se o cliente enviar a seguinte mensagem:

```
Mensagem com opções numeradas:
1. Opção 1
2. Opção 2
3. Opção 3
4. Opção 4
5. Opção 5
6. Opção 6
```

O Treble mostrará a seguinte mensagem:

<img src="https://mintcdn.com/trebleai/woBrUvSBPp-ldiW5/images/message-blocks-10.png?fit=max&auto=format&n=woBrUvSBPp-ldiW5&q=85&s=7a468ffc12ea45b46e971386d5b1f289" alt="Modo de resposta" width="2392" height="1456" data-path="images/message-blocks-10.png" />

#### Modo de resposta

Quando os clientes recebem este tipo de mensagem, podem responder das seguintes formas:

* **Escrevendo o número da opção**: O cliente pode escrever o número da opção que deseja, por exemplo, se o cliente deseja selecionar a opção 1, pode escrever "1".
* **Escrevendo em ordem alfabética da opção**: O cliente pode escrever o texto da opção que deseja, por exemplo, se o cliente deseja selecionar a opção 1, pode escrever "a".
* **Escrevendo o texto que mais se aproxime de alguma das opções**: O cliente pode escrever o texto que mais se aproxime de alguma das opções, por exemplo, se o cliente deseja selecionar a opção 1, a qual tem o texto "Ajuda com meu cartão", pode escrever "cartão".

### Mensagem Simples

<img src="https://mintcdn.com/trebleai/woBrUvSBPp-ldiW5/images/message-blocks-11.png?fit=max&auto=format&n=woBrUvSBPp-ldiW5&q=85&s=9f5e9a9a4ca7362a91a96ac8b3ba2c6e" alt="Mensagem Simples" width="2386" height="1456" data-path="images/message-blocks-11.png" />

Os blocos de mensagem **Mensagem Simples** são usados para mostrar uma mensagem sem opções de resposta ou para capturar uma resposta de texto livre. Esta funcionalidade é particularmente útil para salvar respostas como variáveis.

<Card title="Salvar respostas como variáveis" icon="hashtag" href="/pt/docs/build-with-treble/features/variables">
  Conheça mais sobre como salvar respostas como variáveis.
</Card>

<Check>
  Sucesso! Agora você conhece os blocos de mensagem e como usá-los para criar fluxos de conversação personalizados.
</Check>
