Integrações & Canais

Conectar seus canais de atendimento é o primeiro passo para centralizar todas as conversas da sua empresa em um só lugar. Aqui você aprende a ligar WhatsApp, Web Chat, Telegram, E-mail e SMS ao Golden Chat — e também a integrar automações como n8n, agentes de IA externos e sua loja Shopify.

Visão geral da tela de Integrações

A tela de Integrações é onde você adiciona, edita e monitora todos os canais da empresa.

• Adicionar canal: clique em "Adicionar canal", escolha o canal no seletor e o assistente de conexão (ConnectWizard) abre com os passos daquele canal. Os canais disponíveis no seletor são: WhatsApp via API, WhatsApp via QR Code, Web Chat, Telegram, E-mail e SMS.
• Reconhecer conexões: este botão pergunta a cada canal o estado REAL da conexão (a sessão está viva? o token ainda vale?) e corrige o painel. Essa verificação também roda silenciosamente sempre que você abre a tela.
• Cards dos canais: cada canal conectado vira um card. Um canal conectado ganha o ícone de atendimento; o Web Chat conectado ganha também o ícone de paleta (Palette) para editar a aparência; um canal desconectado ganha a lixeira para remover (o histórico de conversas é preservado). Se o canal apresentar erro, ele aparece no card.

Dica: se algum canal parecer "conectado" mas não estiver recebendo mensagens, use "Reconhecer conexões" antes de refazer tudo do zero — muitas vezes só o painel estava desatualizado.

Aviso: Instagram e Messenger saíram do seletor de novos canais, mas as conexões já feitas continuam funcionando normalmente.

WhatsApp via QR Code

Serve para conectar um número de WhatsApp comum (o mesmo do seu celular) sem precisar de conta na Meta — é o caminho recomendado para quem não tem WhatsApp API oficial.

1. 1Clique em Adicionar canal e escolha WhatsApp via QR Code.
2. 2Clique em Gerar QR Code.
3. 3No celular, abra o WhatsApp → Aparelhos conectados → Conectar aparelho.
4. 4Escaneie o QR Code exibido na tela. Pronto: o número está conectado.

Importante: números conectados por QR Code passam pelo Modo Blindado (veja a seção abaixo), que protege seu número contra bloqueios.

WhatsApp via API oficial (Cloud)

Serve para conectar um número aprovado na API oficial da Meta — necessário para usar templates aprovados, iniciar conversas fora da janela de 24 horas e rodar campanhas.

Caminho recomendado: Conectar com Facebook

1. 1Clique em Adicionar canal e escolha WhatsApp via API.
2. 2Clique em Conectar com Facebook (Embedded Signup).
3. 3Faça login com o Facebook da empresa e escolha o número.
4. 4Pronto — sem precisar copiar e colar nenhum token.

Caminho manual (avançado)

Se preferir configurar manualmente, você vai precisar de:

1. 1Phone Number ID do número.
2. 2App Secret — obrigatório.
3. 3Access Token permanente.
4. 4Verify Token.
5. 5Copie a URL do webhook e o Verify Token mostrados na tela e cadastre-os no painel da Meta.

Pegadinha: sem o App Secret, o webhook não recebe mensagens — a conexão parece feita, mas nada chega na Inbox.

Dica: com o número oficial conectado, você pode criar e submeter templates do WhatsApp na própria tela de Integrações (WhatsAppTemplates). Templates aprovados pela Meta permitem falar primeiro com o cliente, responder fora da janela de 24h e enviar campanhas.

Web Chat (chat do seu site)

Serve para colocar um balão de chat no seu site: o visitante conversa e a mensagem cai direto na sua Inbox.

1. 1Clique em Adicionar canal e escolha Web Chat.
2. 2Personalize a aparência: cor da marca, cor e texto do cabeçalho, tema claro/escuro, título, subtítulo, saudação, card "estamos online", pedir nome/e-mail do visitante e posição do balão (direita ou esquerda). Você vê tudo em prévia ao vivo.
3. 3Em Domínios permitidos, informe os sites onde o chat pode aparecer (deixar vazio permite qualquer site).
4. 4Clique em Ativar widget — isso gera a widgetKey e o código de instalação (HTML ou React/Next), junto com as diretivas de CSP, caso seu site use.
5. 5Copie o código e cole no seu site.

Pegadinha: sem clicar em Ativar widget, o chat não abre no site — mesmo com o código instalado.

Dica: para editar a aparência depois, clique no ícone de paleta (Palette) no card do Web Chat.

Telegram

Serve para atender clientes que preferem o Telegram, usando um bot da sua empresa.

1. 1No Telegram, fale com o @BotFather e use o comando /newbot para criar seu bot.
2. 2Copie o Bot Token que o BotFather entrega.
3. 3No Golden, clique em Adicionar canal → Telegram e cole o token.
4. 4O webhook é configurado automaticamente — não precisa fazer mais nada.

E-mail

Serve para receber e responder e-mails dos clientes dentro da Inbox, como qualquer outra conversa.

1. 1Clique em Adicionar canal e escolha E-mail.
2. 2Escolha o provedor: Resend, SMTP ou IMAP.
3. 3Informe o e-mail de envio e as credenciais do provedor.
4. 4Copie o webhook de entrada e o secret exibidos e cadastre-os no seu provedor.

Dica: o recebimento de e-mails fica pronto assim que o canal é criado; o envio só funciona depois de preencher as credenciais.

SMS (Twilio)

Serve para enviar notificações e campanhas por SMS usando sua conta Twilio.

1. 1Clique em Adicionar canal e escolha SMS.
2. 2Informe o Account SID e o Auth Token da sua conta Twilio.
3. 3Informe o número remetente no formato internacional E.164 (ex.: +5511999999999).

Aviso: o canal SMS é somente envio — ele não recebe respostas dos clientes. Use-o para avisos e campanhas, não para conversa de ida e volta.

Modo Blindado — saúde dos seus números de WhatsApp

O Modo Blindado protege seus números de WhatsApp contra bloqueios, monitorando a "saúde" de cada um e controlando o ritmo de envios.

Na tela de Integrações você acompanha, por número:

• Aquecimento (warm-up): números novos começam devagar e ganham volume aos poucos.
• Uso diário do número.
• Entregues, bloqueios e denúncias, com a taxa de bloqueio.
• Score de 0 a 100 de saúde do número.
• Pausar/retomar envios por número, quando quiser dar um descanso a ele.
• Headline com a % de blindagem do time — a visão geral da saúde de todos os números.

Dica: dentro da conversa (Inbox), o selo do Modo Blindado mostra um pulso verde/âmbar/vermelho com a % de saúde do número — assim o atendente também enxerga quando um número precisa de cuidado.

Mensagens de atendimento por número

Servem para automatizar as mensagens de rotina de cada número, sem depender do atendente lembrar.

Para cada número você pode configurar:

• Saudação: enviada no primeiro contato do cliente.
• Finalização: enviada quando o atendimento é encerrado.
• Inatividade: após um tempo sem resposta do cliente, o Golden pode finalizar a conversa ou enviar uma mensagem (por exemplo, "Ainda está aí?").

Dica: como a configuração é por número, você pode ter saudações diferentes para o número de vendas e o de suporte.

Webhooks de saída (avisar outros sistemas)

Servem para o Golden avisar seus outros sistemas quando algo acontece: ele envia um POST assinado (com o header X-Golden-Signature) para a URL que você indicar.

1. 1Na tela de Integrações, clique em Novo webhook.
2. 2Dê um Nome e informe a URL de destino.
3. 3Escolha os eventos: Novo atendimento, Mensagem recebida, Mensagem enviada, Atendimento finalizado.
4. 4Use Testar para enviar um disparo de teste e confirmar que sua URL está recebendo.

Você também pode copiar a URL, ligar/desligar o webhook e removê-lo a qualquer momento.

Dica de segurança: valide o header X-Golden-Signature no seu sistema para garantir que o aviso veio mesmo do Golden.

Conecte seu n8n / automação (porta de entrada)

Serve para o seu n8n (ou qualquer automação) enviar mensagens ou disparar fluxos pelos seus números do Golden — a direção contrária do webhook de saída.

1. 1Na tela de Integrações, localize Conecte seu n8n / automação.
2. 2Informe um Nome, escolha o número e o tipo: "Responder mensagem" ou "Disparar fluxo".
3. 3Clique em Gerar conexão.
4. 4Copie a URL (que recebe POST), o header `x-webhook-token` e use o exemplo pronto em curl/n8n exibido na tela.

Conecte seu Agente de IA (MCP)

Serve para conectar um agente de IA externo — Claude, ChatGPT ou n8n — ao Golden. O Golden funciona como um servidor MCP: seu agente consegue ler conversas, enviar mensagens e disparar fluxos pelos seus números.

1. 1Na tela de Integrações, localize Conecte seu Agente de IA (MCP).
2. 2Informe um Nome e escolha o número.
3. 3Clique em Gerar conexão.
4. 4Copie a URL do MCP e o Token Bearer. Para quem usa Claude Desktop, a tela já mostra a configuração pronta para colar.

Dica: isto é diferente da configuração de MCP dentro de um agente do Golden (aba Agentes). Lá, o seu agente do Golden consulta um sistema externo; aqui, um agente externo controla o Golden.

Shopify — pedidos da sua loja no Golden

Serve para trazer os pedidos da sua loja Shopify para dentro do Golden: a receita aparece no Dashboard e o agente de IA passa a conseguir consultar status de pedido e entrega para o cliente.

1. 1Na tela de Integrações, localize o card do Shopify.
2. 2Informe o domínio da loja (ex.: minhaloja.myshopify.com).
3. 3Cole o Admin API access token (começa com shpat_…) e o Webhook secret.
4. 4Clique em Conectar Shopify.
5. 5Copie a URL do webhook exibida e cole no painel do Shopify em Notifications → Webhooks, cadastrando os eventos Order creation e Order payment.

Avisos: só admin/gestor pode configurar o Shopify. Se você reabrir a configuração e deixar os campos de token em branco, os valores já salvos são mantidos — não precisa colar de novo.

Dúvidas comuns

Qual WhatsApp devo usar: QR Code ou API oficial?

Se você não tem conta na Meta ou quer começar rápido, use o QR Code (recomendado) — ele ainda ganha a proteção do Modo Blindado. Se precisa de templates aprovados, iniciar conversas fora das 24h e campanhas, use a API oficial.

Conectei o WhatsApp oficial mas não chegam mensagens. E agora?

Na configuração manual, verifique se preencheu o App Secret — sem ele o webhook não recebe mensagens. Depois, use Reconhecer conexões para atualizar o estado real do canal.

Instalei o código do Web Chat no site, mas o balão não aparece.

Confira se você clicou em Ativar widget (sem isso o chat não abre) e se o domínio do seu site está na lista de Domínios permitidos (ou deixe a lista vazia para liberar qualquer site).

Posso receber respostas de SMS?

Não. O canal SMS é somente envio (notificações e campanhas). Para conversa de ida e volta, use WhatsApp, Web Chat, Telegram ou E-mail.

Se eu remover um canal, perco as conversas?

Não. Remover um canal desconectado (ícone de lixeira) preserva todo o histórico de conversas.