> For the complete documentation index, see [llms.txt](https://doc.whazing.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.whazing.com.br/canais-disponiveis/api-oficial/chat-externo-por-link.md).

# Chat externo por link

O **Chat externo por link** é um **modo alternativo** para os canais de **API Oficial (WABA e Hub WhatsApp)**: o cliente continua o atendimento **por uma página de chat na internet, parecida com o WhatsApp**, sem que cada interação consuma uma **mensagem oficial**.

> 💡 **Para que serve:** economizar mensagens da API Oficial. Em vez de continuar gastando mensagens oficiais, você **manda um link** e a conversa segue pela página — sem custo por mensagem.

***

## 🧩 Como funciona, em resumo

1. O **administrador ativa** o recurso nas configurações do sistema (uma vez só).
2. No atendimento, o atendente clica no botão **"Enviar link do chat externo"** (ícone de janelinha abrindo, ao lado do campo de mensagem).
3. O cliente recebe **no WhatsApp** uma mensagem com um **texto** e um **botão** (ex.: **"Abrir Chat"**).
4. Ao tocar no botão, o cliente abre a **página de chat** e continua a conversa por lá.
5. Enquanto isso, o atendente continua vendo tudo **dentro da mesma conversa no Atendimento**, como se fosse uma conversa normal.

<figure><img src="https://858671661-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL28BkT6aCze1NvvWNwS5%2Fuploads%2Fc8PReGtTb9bETpsjcGJm%2Fba39e7d4b4f1e339683279b9f99901-39RSu-1789762482847_3qYtq84DBZ.jpg?alt=media&amp;token=c1671f6d-6a2e-45db-ade3-d4b6710c6374" alt=""><figcaption></figcaption></figure>

<figure><img src="https://858671661-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL28BkT6aCze1NvvWNwS5%2Fuploads%2FIxJZ3C7N0poJ3ly0TrO5%2F9b271e2d44c24f39a81cf77e97d16b-i4psu-1789762623423_ATXmKO1H6P.jpg?alt=media&amp;token=8397b06b-13ed-40b1-b234-088c6da7a4d3" alt=""><figcaption></figcaption></figure>

***

## ⚙️ Ativando e configurando (administrador)

1. Acesse **Configurações de Atendimento → Configurações do Atendimento.**
2. Localize **"Modo alternativo (chat externo por link)"** e **ative o interruptor**.
3. Ajuste as opções, se quiser:

| Opção                               | O que faz                                                                                                                             |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **Pedir senha para acessar o chat** | Ao abrir o link, o cliente precisa informar **os 4 últimos números do próprio telefone** — protege o chat caso alguém encontre o link |
| **Texto da mensagem do link**       | A frase enviada junto com o botão no WhatsApp. Padrão: *"Toque no botão abaixo para continuar esta conversa pelo navegador."*         |
| **Texto do botão**                  | O que está escrito no botão. Padrão: **"Abrir Chat"** (máximo de 30 caracteres)                                                       |

<figure><img src="https://858671661-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL28BkT6aCze1NvvWNwS5%2Fuploads%2Fnyu5hxVSaw0rSKEgHwk9%2Fconfalternativo.png?alt=media&amp;token=e74e14b6-2d88-40a1-a850-78e922b0ae6a" alt=""><figcaption></figcaption></figure>

***

## 🚀 Como o atendente envia o link

* O botão **"Enviar link do chat externo"** aparece **somente em conversas dos canais Hub WhatsApp e WABA**, com o atendimento **em aberto** e **enquanto o chat externo não estiver ativo**;
* Ao clicar, o sistema envia a mensagem com o botão ao cliente e confirma: **"Link do chat externo enviado ao cliente"**;
* O próprio sistema grava a mensagem do link **no histórico da conversa**.

> 💡 Dica de uso: o chat externo é especialmente útil **quando a janela de 24 horas fecha** — em vez de gastar um template para reabrir, continue pelo link.

***

## 👤 O que o cliente vê e pode fazer

A página do cliente é simples e parecida com o WhatsApp:

* **Conversa completa** — o histórico do atendimento aparece como bolhas de conversa;
* **Enviar mensagens de texto**, com **emojis**;
* **Enviar imagens** (tocar para ampliar) e **documentos em PDF**;
* **Gravar e enviar áudio**;
* **Cartões interativos** — botões, listas de opções e carrossel enviados pelo atendente/bot funcionam na página (o cliente clica e responde);
* **Cartão de pagamento** — quando o atendente envia uma cobrança/chave Pix, a página mostra o cartão com a chave e o botão **copiar**;
* **Cartão de contato** e **localização** — mensagens estruturadas aparecem formatadas;
* Se ativado, **informar os 4 últimos números do telefone** antes de entrar;
* Quando o atendimento é **encerrado**, a página avisa: *"Este atendimento foi encerrado. Se precisar de algo, mande uma mensagem no WhatsApp novamente."*

> ⚠️ **Limitações:** a página aceita **texto, imagem, PDF, áudio** e as mensagens estruturadas listadas acima (**botões, listas, carrossel, contato, localização e cartão de pagamento/Pix**). Recursos exclusivos do WhatsApp — como stickers e a localização **em tempo real** — não fazem parte do chat externo. Se o link expirar, a página informa: *"Este link não é mais válido. Peça um novo link ao atendente."*

***

## 🖥️ O que muda para o atendente

Enquanto o chat externo está ativo, um **banner** aparece acima do campo de mensagem:

* 🟢 **"Chat externo ativo — suas mensagens vão pelo chat, não pelo WhatsApp"**;
* **Cliente online / Cliente offline** — uma luzinha mostra se o cliente está na página neste momento;
* Botão **"Voltar para WhatsApp"** — **encerra o modo alternativo** e devolve a conversa ao fluxo normal do WhatsApp (as próximas mensagens voltam a ser oficiais).

O restante é igual: as respostas do cliente **chegam na mesma conversa**, com notificação normal, e você responde pelo mesmo campo de sempre.

<figure><img src="https://858671661-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL28BkT6aCze1NvvWNwS5%2Fuploads%2F9aaexCjCz5FpMsfDgzQU%2Fatendimentochatexterno.png?alt=media&amp;token=09417987-4068-48f8-89db-fed524c0187d" alt=""><figcaption></figcaption></figure>

<figure><img src="https://858671661-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL28BkT6aCze1NvvWNwS5%2Fuploads%2Fjj9YW3spwEbb3zJIgKzn%2F2500231637141140_iTt9Lp1f1c.jpeg?alt=media&amp;token=d4851bf0-3e6a-47f8-b0de-3acea3041c61" alt=""><figcaption></figcaption></figure>

***

## 📱 Em quais canais funciona

* **WABA** (WhatsApp API Oficial);
* **Hub WhatsApp** (API Oficial via Hub).

Não aparece em canais não oficiais, Instagram, Facebook, Telegram, WebChat, SMS ou e-mail — nesses canais cada mensagem não tem o custo da API Oficial, então não há o que economizar.

***

## ❓ Problemas comuns

**"O botão de enviar o link não aparece."** Ele só existe em conversas de **WABA/Hub WhatsApp** e com o atendimento **em aberto**. Se o chat externo **já está ativo** nessa conversa, o botão some — o que aparece é o banner com **"Voltar para WhatsApp"**.

**"O cliente abriu o link e pediu senha."** A senha são os **4 últimos números do telefone dele** — o sistema pede para proteger o chat. Se não quiser esse passo, desative **"Pedir senha para acessar o chat"** nas configurações.

**"O cliente diz que o link não abre mais."** O link pode ter expirado. Clique novamente em **"Enviar link do chat externo"** para gerar e reenviar.

**"Mudei de ideia e quero voltar ao WhatsApp."** Clique em **"Voltar para WhatsApp"** no banner acima do campo de mensagem. A conversa segue normalmente pelo WhatsApp.

**"Não achei a opção de ativar o chat externo."** Ela fica em **Configurações → Atendimento**, com o nome **"Modo alternativo (chat externo por link)"**. Somente administradores têm acesso às configurações.

***

> 📄 Veja também: [Concatenador de Mensagens](/canais-disponiveis/api-oficial/concatenador-de-mensagens.md) — juntar mensagens para economizar · [Franquia mensal grátis](/canais-disponiveis/api-oficial/franquia-mensal-gratis.md)