Guia de integração

Documentação do widget

Saiba como adicionar o TalkTG ao site, da instalação básica à personalização.

Conteúdo

Início rápido

Cole uma linha de código e comece em poucos minutos.

Cadastre-se e adicione um site

Crie sua conta, abra “Sites”, selecione “Adicionar site” e informe seu domínio.

Conecte um bot do Telegram

Crie um bot com @BotFather, copie o Token, conecte-o ao site e envie /start ao bot.

Cole o código do widget

Copie o código de incorporação e coloque-o logo antes de </body> no HTML.

Pré-requisitos

1Uma conta TalkTG
2Um site cujo HTML você possa editar
3Um Telegram Bot Token criado com @BotFather

Instalação

Substitua YOUR_SITE_ID pelo ID do site exibido no painel.

<script src="https://talktg.com/widget.js"
  data-site-id="YOUR_SITE_ID" async></script>

HTML básico

Adicione o script antes da tag de fechamento </body>.

Next.js / React

Use o componente Script do Next.js no layout raiz.

Vue / Nuxt

Adicione em app.head.script no nuxt.config.ts.

WordPress

Adicione antes de </body> no footer.php ou use um plugin de cabeçalho e rodapé.

Shopify

Adicione antes de </body> no theme.liquid.

Wix

Adicione código personalizado no fim do Body e aplique a todas as páginas.

Configuração do widget

Acesse “Sites → Seu site → Configurações do widget” para alterar aparência e comportamento.

Opção	Padrão	Descrição
Cor principal	`#6366F1`	Cor do botão, cabeçalho e mensagens do visitante.
Posição	`bottom-right`	Canto inferior direito ou esquerdo.
Saudação	`Hi there!`	Mensagem mostrada a novos visitantes.
Nome do agente	`Support`	Nome exibido no cabeçalho do chat.
Abertura automática	`false`	Mostra automaticamente a saudação.
Som	`true`	Toca um som ao receber uma resposta.

Referência da API

O widget usa estas APIs públicas internamente; normalmente você não precisa chamá-las.

GET/api/widget/config/{siteId}

Obtém a configuração do widget.

GET/api/sites/{siteId}/status

Verifica o status do bot do Telegram.

POST/api/chat/send

Envia uma mensagem do visitante.

GET/api/chat/history

Carrega o histórico da conversa.

GET/api/chat/poll

Consulta novas mensagens.

Como funciona

O script carrega de forma assíncrona e isola estilos com Shadow DOM.

As mensagens são encaminhadas ao Telegram conectado pelo TalkTG.

Suas respostas no Telegram aparecem no chat do site.

A identidade fica salva no navegador para continuar a conversa em outra visita.

Perguntas e solução de problemas

O widget não aparece

Confira a posição do script, o ID do site e os erros no console.

Não recebo mensagens no Telegram

Envie /start ao bot e confirme que o painel mostra “conectado”.

Posso usar vários domínios?

Cada site corresponde a um domínio; crie um site para cada domínio.

O widget deixa o site lento?

Não. Ele carrega com async e não bloqueia a renderização.

Pronto para começar?

Configure em poucos minutos, sem cartão de crédito.

Criar conta grátis Voltar ao início