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

# Botões do WhatsApp

## GoGHL.ai | Guia de Configuração dos Botões do WhatsApp[​](#goghlai--guia-de-configuração-dos-botões-do-whatsapp "Link direto para GoGHL.ai | Guia de Configuração dos Botões do WhatsApp")

Este guia explica como criar Mensagens com Botões no GoGHL.ai. Siga os formatos com atenção; depois que você se acostumar, criar botões levará apenas alguns minutos.

## O que são os Botões do WhatsApp?[​](#o-que-são-os-botões-do-whatsapp "Link direto para O que são os Botões do WhatsApp?")

Os Botões do WhatsApp são elementos interativos que permitem que seus clientes realizem ações rápidas sem digitar. Em vez de escrever uma resposta, eles podem simplesmente tocar em um botão para:

* Selecionar uma opção de um menu
* Abrir um site
* Ligar para um número
* Copiar um código de cupom

## Quem deveria usá-los?[​](#quem-deveria-usá-los "Link direto para Quem deveria usá-los?")

* Agências: Para ajudar os clientes a construir fluxos interativos e melhorar as taxas de resposta.
* Empresas: Para suporte ao cliente mais rápido, catálogos de produtos, fluxos de agendamento ou campanhas de marketing.
* Equipes de vendas: Para coletar respostas estruturadas (como "Agendar Demo" ou "Ver Preços") instantaneamente.

## Quais tipos de botões estão disponíveis?[​](#quais-tipos-de-botões-estão-disponíveis "Link direto para Quais tipos de botões estão disponíveis?")

* Resposta Rápida → Os clientes tocam e respondem instantaneamente com uma resposta predefinida.
* CTA URL → Abre uma página web diretamente.
* CTA Ligação → Liga para um número de telefone com um toque.
* CTA Copiar → Copia um texto ou um código de cupom.

## Termos-Chave (Definições Rápidas)[​](#termos-chave-definições-rápidas "Link direto para Termos-Chave (Definições Rápidas)")

* Prefixo de Comando: O código especial (#btn) que informa ao GoGHL que tipo de mensagem você está enviando.
* Seção: Um agrupamento de múltiplas opções (ex.: "Eletrônicos" ou "Roupas" em um catálogo).
* ID da Opção: Um identificador único para cada botão (usado para rastrear qual opção foi clicada).
* Cabeçalho de Mídia: Uma imagem ou vídeo opcional no topo de uma Mensagem com Botões.

## Mensagens com Botões[​](#mensagens-com-botões "Link direto para Mensagens com Botões")

### Formato[​](#formato "Link direto para o Formato")

```text theme={null}
#btn|title|subTitle|mediaType*mediaUrl|buttonType*buttonText*buttonId
```

### Exemplo[​](#exemplo "Link direto para o Exemplo")

```text theme={null}
#btn|Welcome!|Choose an action|image*https://filesamples.com/samples/image/jpeg/sample_640%C3%97426.jpeg|quick_reply*Get Started*start_btn|cta_url*Visit Website*https://example.com|cta_call*Call Me*+919999999999|cta_copy*Copy Coupon*blackfriday50
```

### Detalhamento do Formato[​](#detalhamento-do-formato "Link direto para o Detalhamento do Formato")

\#btn → Prefixo de comando

title → Texto principal do corpo da mensagem

subTitle → Texto opcional abaixo do título (undefined para omitir)

mediaType\*mediaUrl → Cabeçalho opcional (ex.: image\*URL, video\*URL ou undefined)

buttonType\*buttonText\*buttonId → Definições dos botões (múltiplos são permitidos)

<Warning>
  Certifique-se de usar **`undefined`** para qualquer parâmetro opcional que você não queira incluir. Por exemplo, se você não quiser um subtítulo, use `undefined` em vez de deixá-lo vazio.
</Warning>

### Tipos de Botões[​](#tipos-de-botões "Link direto para os Tipos de Botões")

quick\_reply → Opção de resposta simples

Exemplo: `quick_reply*Get Started*start_btn`

cta\_url → Abre uma URL

Exemplo: `cta_url*Visit Website*https://example.com`

cta\_call → Liga para um número de telefone (formato internacional)

Exemplo: `cta_call*Call Me*+919999999999`

cta\_copy → Copia um código ou valor

Exemplo: `cta_copy*Copy Coupon*blackfriday50`

## Dicas[​](#dicas "Link direto para as Dicas")

* Sempre teste o seu botão antes de enviá-lo aos clientes.
* Mantenha o texto do botão curto (≤ 20–25 caracteres).
* Use Mensagens com Botões para ações diretas (ligação, link, cupom).
* Forneça um texto alternativo (ex.: "Responda 1, 2 ou 3 se os botões não aparecerem") para usuários em dispositivos mais antigos.

Com esses formatos, você pode construir menus e botões interativos de WhatsApp diretamente no GoGHL.ai, tornando as interações com seus clientes mais rápidas, fáceis e envolventes.

***

## Construtor de Botões (Sem Código)[​](#construtor-de-botões-sem-código "Link direto para o Construtor de Botões (Sem Código)")

Prefere um jeito mais rápido? Use nosso Construtor de Botões visual para gerar payloads de botões válidos sem memorizar formatos. Ele valida a estrutura, escapa caracteres especiais e permite pré-visualizar antes de enviar.

* Abra o construtor: [builder.goghl.ai](https://builder.goghl.ai/)
* Crie botões de Resposta Rápida, CTA URL, CTA Ligação ou CTA Copiar
* Copie a string gerada e cole-a no seu workflow ou conversa do GoGHL

<Frame>
  <img src="https://mintcdn.com/goghl/JZJa2MoUHOf9Nw9w/images/features/assets/images/button-builder-06fb30821f458c637fad95ff4739ce41.jpeg?fit=max&auto=format&n=JZJa2MoUHOf9Nw9w&q=85&s=c7439635605696e1c1056ac517a97928" alt="Captura de tela do Construtor" width="1920" height="1280" data-path="images/features/assets/images/button-builder-06fb30821f458c637fad95ff4739ce41.jpeg" />
</Frame>

### Habilitar o Construtor de Botões para Todas as Subcontas (Whitelabel)[​](#habilitar-o-construtor-de-botões-para-todas-as-subcontas-whitelabel "Link direto para Habilitar o Construtor de Botões para Todas as Subcontas (Whitelabel)")

Quer habilitar o Construtor de Botões como um ícone global para todas as suas subcontas? Siga estes passos:

<Steps>
  <Step>
    Na **Visão de Agência**, vá para **Configurações**
  </Step>

  <Step>
    Navegue até **Empresa** → **Whitelabel**
  </Step>

  <Step>
    Role para baixo até a seção **Custom JS**
  </Step>

  <Step>
    Adicione o seguinte script:

    ```text theme={null}
    <script src="https://builder.goghl.ai/embed.js"></script>
    ```
  </Step>

  <Step>
    Clique em **Salvar** e atualize a página
  </Step>
</Steps>

Uma vez habilitado, o ícone do Construtor de Botões aparecerá globalmente em todas as suas subcontas!

<Frame>
  <img src="https://mintcdn.com/goghl/JZJa2MoUHOf9Nw9w/images/features/assets/images/how-to-add-button-builder-b09bb03b4cfcb817c26fcb147f30d2e7.gif?s=a88aaad308e5938bf5deb4b0f0fcff09" alt="Como Adicionar o Construtor de Botões" width="1005" height="565" data-path="images/features/assets/images/how-to-add-button-builder-b09bb03b4cfcb817c26fcb147f30d2e7.gif" />
</Frame>

***

## Suporte[​](#suporte "Link direto para o Suporte")

Se você precisar de ajuda com a configuração ou o onboarding:

* Suporte no WhatsApp: [Conversar no WhatsApp](https://wa.me/+12267248710?text=Hi%2C%20I%20need%20help%20with%20WhatsApp%20Buttons.)
* Email: [**support@goghl.ai**](mailto:support@goghl.ai)