Outros canais

Como configurar um canal no Instagram?

Se você está usando uma instalação auto-hospedada do Chatwoot, por favor configure seu aplicativo Instagram conforme descrito neste guia. Para a versão em nuvem do Chatwoot, siga este guia. Pré-requisitos Antes de trazer sua caixa de entrada do Instagram para o Chatwoot, você precisa garantir que possui uma conta comercial no Instagram. Configure uma conta comercial no Instagram caso ainda não tenha uma. Este guia do Instagram irá te ajudar nesse processo. Como criar uma caixa de entrada do Instagram no Chatwoot? Passo 1. Vá em Configurações → Caixas de Entrada → “Adicionar Caixa de Entrada”. Passo 2. Clique no botão "Continuar com o Instagram". Passo 3. Habilite "Acessar e gerenciar mensagens" e clique no botão permitir para continuar a autorização Passo 5. "Adicionar agentes" à sua caixa de entrada do Instagram. Você criou com sucesso uma caixa de entrada do Instagram. Sempre que um cliente enviar uma mensagem para sua conta do Instagram, você poderá visualizá-la e respondê-la no Chatwoot.

1. WhatsApp no Chatwoot

Conecte seu número do WhatsApp Business ao Chatwoot e sua equipe poderá responder aos chats do WhatsApp a partir de uma caixa de entrada compartilhada, junto com seus outros canais. Você também pode enviar mensagens de modelo aprovadas, executar campanhas de transmissão, coletar avaliações de CSAT e atender chamadas do WhatsApp. O que você pode fazer no WhatsApp | Capacidade | O que faz | Saiba mais | | ---------------------------- | ------------------------------------------------------------------------------------------------------------ | ----------------------------------- | | Caixa compartilhada do WhatsApp | As mensagens dos clientes chegam como conversas que sua equipe pode atribuir, rotular, responder e resolver | 2. Escolha como conectar o WhatsApp | | Mensagens de modelo | Inicie uma conversa, ou responda após 24 horas, com uma mensagem aprovada pela Meta | 7. Modelos e a janela de 24 horas | | Campanhas | Envie um modelo aprovado para cada contato com os rótulos escolhidos. Plano Business ou superior. | 8. Campanhas no WhatsApp | | Pesquisas de CSAT | Solicite uma avaliação quando uma conversa for resolvida, mesmo após o fechamento da janela de 24 horas | 9. Pesquisas de CSAT no WhatsApp | | Chamadas | Clientes ligam para sua empresa pelo WhatsApp e agentes atendem no navegador | 10. Chamadas pelo WhatsApp | | Saúde da conta | Veja o status do seu número, limite de mensagens, revisão do nome de exibição e perfil empresarial no Chatwoot | 11. Gerencie seu número do WhatsApp | Plano & acesso | | Chatwoot Cloud | Auto-hospedado | | ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Caixa WhatsApp (qualquer método de conexão) | Planos Startups e superiores, e o teste gratuito. Não disponível no plano gratuito Hacker. | Incluído | | Configuração rápida com Meta (a forma mais rápida) | Incluído a partir do plano Startups. Durante o teste gratuito, clique em Solicitar acesso na tela de configuração e envie seu caso de uso para ativar. | Apenas se sua instalação tiver seu próprio app Meta configurado para isso. A maioria das instalações auto-hospedadas usa a configuração manual. | | Campanhas WhatsApp: envio | Plano Business ou superior. Disponível automaticamente, sem necessidade de solicitação. | Não é um recurso premium. Funciona na Community Edition e está ativado por padrão. | | Análises de campanha | Plano Business ou superior | Requer um plano pago auto-hospedado. O super admin da sua instalação ativa Análises de Campanhas em Super Admin › Contas › abrir a conta › Editar, em Recursos Premium, depois clica em Salvar alterações. | | Chamadas | Plano Business ou superior | Requer um plano pago auto-hospedado com Enterprise Edition, a partir da v4.15.0. Instalar apenas o build da Enterprise Edition não habilita o recurso. | | Modelos, pesquisas CSAT, saúde da conta | Todo plano que inclui WhatsApp | Incluído | Quem pode fazer o quê: - Administradores conectam caixas de entrada e alteram as configurações da caixa. - Agentes adicionados à caixa respondem conversas e enviam modelos. Veja Preços & Planos para saber o que cada plano inclui. Seu método de conexão decide o que você pode usar O Chatwoot conecta ao WhatsApp de três maneiras. Escolha antes de conectar, pois alguns recursos só funcionam com o WhatsApp Cloud API. | | Configuração rápida com Meta(WhatsApp Cloud API) | Configuração manual(WhatsApp Cloud API) | Twilio | | -------------------------------------------------- | --------------------------------------------------- | ------------------------------------------ | --------------------------------------- | | Esforço de configuração | Alguns minutos em uma janela Meta. Sem configuração de desenvolvedor. | App Meta, token de usuário do sistema e webhook | Conta Twilio, credenciais e webhook | | Continuar usando o app WhatsApp Business no celular | ✅ (Coexistência) | ❌ | ❌ | | Mensagens de modelo | ✅ | ✅ | ✅ Modelos de conteúdo Twilio | | Campanhas | ✅ | ✅ | ❌ | | Pesquisas CSAT após 24 horas | ✅ | ✅ | ✅ | | Chamadas | ✅ | ✅ | ❌ | | Aba Saúde da conta | ✅ | ✅ | ❌ | | Disponível em | Chatwoot Cloud | Cloud e auto-hospedado | Cloud e auto-hospedado | Usando 360dialog? O 360dialog não é mais oferecido para novas caixas de entrada. As caixas de entrada 360dialog existentes continuam funcionando para conversas, mas não podem usar campanhas, chamadas ou modelos de CSAT. Como verificar o que você tem - Seu tipo de caixa: vá em Configurações › Caixas de entrada e abra sua caixa do WhatsApp. Uma aba Saúde da Conta indica que é uma caixa WhatsApp Cloud API. - Configuração rápida: na tela de configuração do WhatsApp, uma caixa Solicitar acesso em vez do botão de conectar indica que o modo rápido ainda não está habilitado para sua conta. - Campanhas: WhatsApp em Campanhas na barra lateral indica que campanhas estão disponíveis para sua conta. - Chamadas: uma aba Chamadas nas configurações da caixa indica que chamadas estão disponíveis para sua conta. Seu caminho neste guia 1. Conectar: Escolha como conectar o WhatsApp, depois vá para a página do seu método (3, 4 ou 5). 2. Aprenda a regra que define o WhatsApp: Modelos e a janela de 24 horas. 3. Adicione o que precisar: campanhas (8), CSAT (9), chamadas (10). 4. Mantenha saudável: Gerencie seu número do WhatsApp. 5. Quando algo der errado: Solucione problemas do WhatsApp.

3. Conectar com configuração rápida com o Meta

Configuração rápida com a Meta (também chamada de Cadastro Incorporado) conecta seu número através de uma janela da Meta. O Chatwoot configura o webhook, token e número de telefone para você. Plano & acesso - Somente Chatwoot Cloud. Incluído a partir do plano Startups. Durante o teste gratuito, clique em Solicitar acesso, descreva como você usará o WhatsApp e clique em Enviar para ativá-lo. O WhatsApp não está disponível no plano gratuito Hacker. Veja Preços & Planos. - Somente Administradores. Antes de começar - Faça login no Facebook usando uma conta que seja admin do portfólio de negócios correto da Meta. - Permita pop-ups para o Chatwoot e o Facebook. - Mantendo o aplicativo WhatsApp Business (Coexistência): atualize o app para a versão mais recente e mantenha o telefone online. A Coexistência funciona com o aplicativo WhatsApp Business, não com o aplicativo pessoal do WhatsApp. A Meta decide quais números são elegíveis. Conecte seu número 1. Vá em Configurações › Caixas de Entrada › Adicionar Caixa de Entrada › WhatsApp e escolha WhatsApp Cloud. 2. Clique em Conectar com WhatsApp Business. Uma janela da Meta será aberta. 3. Na janela da Meta, faça login e, em seguida, escolha ou crie seu portfólio de negócios e a Conta Comercial do WhatsApp. 4. Escolha seu número: - Um novo número: digite-o e verifique com o código que a Meta envia por SMS ou chamada de voz. - Um número no aplicativo WhatsApp Business (Coexistência): escolha conectar seu aplicativo existente, então: 1. Copie o código de verificação exibido na janela da Meta. 2. No seu telefone, abra a mensagem do Facebook Business, toque em Conectar e depois em Conectar à Plataforma de Negócios. 3. Toque em Confirmar e escolha se deseja compartilhar o histórico de conversas. 4. Digite o código copiado no app e finalize as etapas na janela da Meta. 5. Quando você vir Conta do WhatsApp Business Conectada!, adicione os agentes que devem responder essa caixa de entrada. Teste: envie uma mensagem WhatsApp para seu número comercial a partir de outro telefone. Ela deve aparecer como uma nova conversa. Responda pelo Chatwoot e verifique se a mensagem chegou. Com a Coexistência, confira também se o app no seu telefone continua funcionando. O que acontece a seguir - Modelos aprovados em sua Conta Comercial do WhatsApp são sincronizados automaticamente com o Chatwoot. Veja Modelos e a janela de 24 horas. - Chamadas: se chamadas estiverem disponíveis no seu plano, o Chatwoot tenta ativá-las durante a configuração. Se seu número não estiver inscrito na API de Chamadas da Meta, a caixa de entrada será criada e você poderá ativar as chamadas depois. Veja Chamadas WhatsApp. - Histórico de conversas (Coexistência): a Meta sincroniza o histórico apenas dentro de 24 horas após a conexão. Mantenha o app aberto e com conexão estável. Grandes históricos podem demorar mais. - Análises da Meta: a Meta pode pedir que você verifique sua empresa (faça upload de documentos) e irá revisar seu nome de exibição. Acompanhe ambos em Saúde da Conta. Veja Gerencie seu número WhatsApp. Se a Configuração rápida estiver indisponível Às vezes, a Meta restringe a Configuração rápida para todos os provedores. O Chatwoot então exibe um aviso na tela de configuração. Durante esse período: - Números já na API WhatsApp Cloud podem usar a configuração manual. Veja Conectar com WhatsApp Cloud API (configuração manual). - Números usando Coexistência não podem ser conectados até que a restrição seja removida. Algo deu errado? Veja Conectando em Solucionar problemas do WhatsApp. Cobre todos os códigos de erro da Meta que você pode encontrar durante esse processo.

Como configurar um canal no Line?

Passo 1. Vá em Configurações → Caixas de entrada → “Adicionar caixa de entrada”. Passo 2. Clique no ícone "Line". Passo 3. Acesse o Line Developer Console e crie uma conta Line. Passo 4. Crie um "Provider" no console do desenvolvedor. Crie um novo canal "Messaging API" (Bot) sob o provider. Passo 5. Preencha os campos abaixo com as informações do console do desenvolvedor Line (canal Messaging API) e clique em "Criar canal LINE". 1. Nome do canal 2. LINE Channel ID 3. LINE Channel Secret 4. LINE Channel Token Passo 6. "Adicione agentes" à sua caixa de entrada Line. A configuração da caixa de entrada está concluída. Passo 7. Vá até o canal "Messaging API" no console do desenvolvedor e configure o webhook. 1. Verifique a URL do webhook do Chatwoot 2. Ative "Usar webhook" Passo 8. Teste sua nova caixa de entrada Line. Envie uma mensagem para o bot Line. Verifique a caixa de entrada Line do Chatwoot pela nova mensagem.

Como criar um canal no TikTok?

Se você está usando uma instalação Chatwoot auto-hospedada, configure seu aplicativo TikTok conforme descrito neste guia. Para a versão em nuvem do Chatwoot, siga este guia. Pré-requisitos Antes de configurar o canal TikTok, certifique-se do seguinte: 1. Você possui uma Conta Comercial do TikTok registrada em uma região elegível. 2. Sua Conta Comercial do TikTok está configurada para aceitar mensagens diretas de todos. Caso contrário, você precisará aceitar manualmente as mensagens no aplicativo TikTok. Saiba como atualizar suas configurações de mensagem Configurando o Canal TikTok Passo 1: Acesse as Caixas de Entrada Vá em Configurações > Caixas de Entrada e clique em Adicionar Caixa de Entrada. Selecione TikTok na lista de canais disponíveis. Passo 2: Conecte Sua Conta TikTok Clique em Continuar com TikTok para iniciar o processo de autenticação. Passo 4: Autorize o Chatwoot Você será redirecionado para o TikTok. Revise as permissões solicitadas e clique em Continuar para autorizar o Chatwoot a acessar sua Conta Comercial do TikTok. Passo 5: Adicione Agentes Após a autorização, você será redirecionado de volta ao Chatwoot. Adicione agentes à caixa de entrada do TikTok para que eles possam visualizar e responder às mensagens. Seu canal TikTok está agora conectado. As mensagens diretas recebidas pelo TikTok aparecerão em seu painel do Chatwoot. Limitações de Mensagens - Os clientes precisam iniciar a conversa, as empresas não podem enviar mensagens primeiro. - Os agentes podem enviar até 10 mensagens antes que o cliente responda. Depois que o cliente responder, o envio de mensagens é ilimitado. - A janela de resposta é de 48 horas a partir da última mensagem do cliente. - Apenas mensagens do tipo texto, imagem e compartilhamento de post são suportadas atualmente devido a limitações da API de Mensagens Comerciais do TikTok. - As mensagens enviadas diretamente pelo aplicativo TikTok serão sincronizadas no Chatwoot. - Mensagens recebidas em formatos não suportados (por exemplo, áudio, figurinhas) aparecerão como "Esta mensagem não é suportada. Você pode visualizar esta mensagem no aplicativo TikTok." Perguntas Frequentes Por que não consigo enviar mensagens de mídia para alguns usuários do TikTok? Isso acontece devido a restrições do TikTok. Algumas regiões não permitem o envio ou recebimento de imagens e, em outros casos, a conta do usuário pode estar sinalizada pelo TikTok. Quais países suportam Mensagens Comerciais do TikTok? A API de Mensagens Comerciais do TikTok não está atualmente disponível no EEE, Suíça ou Reino Unido. Os recursos de mensagens podem ser limitados ou indisponíveis para usuários nessas regiões. Para as regiões suportadas e restrições mais recentes, consulte a documentação oficial do TikTok. Disponibilidade O TikTok está disponível tanto nos planos em Nuvem quanto Auto-hospedado.

Como configurar um canal de SMS?

Você pode configurar sua caixa de entrada do canal SMS através de dois provedores: 1. Twilio 2. Bandwidth Criando uma caixa de entrada SMS Siga os passos abaixo. Passo 1. Abra seu painel do Chatwoot. Vá para Configurações → Caixas de entrada → Adicionar Caixa de entrada. Passo 2. Clique no ícone "SMS". Passo 3. Escolha seu provedor de API e configure a caixa de entrada. As duas opções são explicadas abaixo. Escolhendo "Twilio" como provedor de API Se você deseja usar o Twilio para configurar sua caixa de entrada SMS, selecione essa opção no menu suspenso. Serão exibidos os campos obrigatórios conforme explicado abaixo. Esses são os campos necessários para criar esse canal: Clique em Criar Canal Twilio após preencher as informações. Configurando o Chatwoot com Twilio Studio​ Se você utiliza o Twilio Studio para um fluxo de conversa personalizado, atualizar a URL do webhook diretamente vai quebrar sua integração existente. Para esses casos, você pode navegar até a seção "Twilio Studio" neste documento. Escolhendo "Bandwidth" como provedor de API Se você deseja usar Bandwidth para configurar sua caixa de entrada SMS, selecione essa opção no menu suspenso. Serão exibidos os campos obrigatórios conforme mostrado abaixo. Clique em Criar Canal Bandwidth após preencher as informações. Depois de concluir essa etapa, prossiga para adicionar agentes. Passo 4. "Adicione agentes" à sua caixa de entrada. Você criou com sucesso uma caixa de entrada SMS. Você começará a receber as mensagens no seu painel do Chatwoot. Veja também: Enviando uma campanha SMS para um grupo de contatos.

Como configurar um canal no Instagram (usando login do Facebook)?

Recomendamos o Login Comercial do Instagram como o método de autenticação preferido, pois proporciona uma configuração mais simples e uma melhor experiência para o desenvolvedor. Consulte este guia para mais detalhes. O suporte ao Instagram via Login do Facebook será descontinuado a partir da versão 4.1. Se você utiliza uma instalação Chatwoot auto-hospedada, por favor, configure seu aplicativo do Instagram conforme descrito neste guia. Para a versão em nuvem do Chatwoot, siga este guia. Pré-requisitos Antes de conectar sua caixa de entrada do Instagram ao Chatwoot, você precisa garantir que possui uma conta comercial no Instagram. Passo 1. Configure uma conta comercial do Instagram se ainda não tiver uma. Este guia do Instagram vai te ajudar com isso. Passo 2. Certifique-se de que sua página do Facebook está conectada a essa conta do Instagram. Para conectar o Facebook ao Instagram, siga estes passos: 1. Acesse https://www.facebook.com/pages/?category=your_pages. 2. Selecione sua página. 3. Vá em Configurações. 4. Selecione “Instagram” e conecte sua conta comercial conforme mostrado abaixo: Agora volte para o aplicativo Chatwoot. Como criar uma caixa de entrada do Instagram no Chatwoot? Passo 1. Vá em Configurações → Caixas de Entrada → “Adicionar Caixa de Entrada”. Passo 2. Clique no ícone do "Messenger". Passo 3. Clique no botão de login do Facebook. Uma nova janela será aberta para você fazer o login. Passo 4. Autentique-se com o Facebook, selecione uma conta do Instagram e selecione a página que deseja conectar. Habilite todas as permissões mostradas na lista. Isso ajudará o Chatwoot a realizar todas as ações desejadas sem problemas. Passo 5. "Adicione agentes" à sua caixa de entrada do Instagram. Você criou com sucesso uma caixa de entrada do Instagram. Sempre que um cliente enviar uma mensagem para a sua conta do Instagram, você poderá visualizá-la e respondê-la no Chatwoot.

Como criar um canal no Twitter?

NOTA: A integração com o Twitter foi temporariamente descontinuada devido a modificações feitas pelo Twitter em suas APIs. Isso inclui limitações na quantidade de solicitações permitidas por minuto, além de mudanças substanciais nos preços. Com uma caixa de entrada do Twitter, você pode gerenciar tanto tweets que mencionam você quanto suas DMs do Twitter pelo Chatwoot. Se você está utilizando uma instalação auto-hospedada do Chatwoot, por favor configure sua caixa de entrada do Twitter conforme descrito neste guia. Para a versão em nuvem do Chatwoot, siga os passos abaixo. Passo 1. Vá em Configurações → Caixas de Entrada → “Adicionar Caixa de Entrada”. Passo 2. Clique no ícone "Twitter". Passo 3. Clique no botão "Entrar com o Twitter". Passo 4. Você será redirecionado para o Twitter. Clique no botão "Autorizar aplicativo". Passo 5. "Adicione agentes" à sua caixa de entrada do Twitter. Você criou com sucesso uma caixa de entrada do Twitter. Agora você poderá gerenciar DMs do Twitter, bem como tweets que mencionam você, direto pelo Chatwoot. Configurações adicionais da caixa de entrada​ Sua caixa de entrada do Twitter recém-configurada deve agora aparecer na sua lista de caixas de entrada. Para visualizar e fazer configurações adicionais em sua caixa do Twitter, vá para Configurações → Caixas de Entrada → clique no ícone de engrenagem na caixa de entrada do Twitter correspondente. Você verá a seguinte tela: Você pode fazer algumas alterações fundamentais aqui. Aba Configurações​ Habilitar saudação do canal. Uma vez habilitado, o Chatwoot enviará uma mensagem de saudação para novas conversas criadas através da sua caixa de entrada do Twitter. Habilitar CSAT. Ao habilitar esta opção, sua pesquisa de Satisfação do Cliente será enviada sempre que um ticket for resolvido. Os resultados do CSAT podem ser visualizados depois na seção de Relatórios. Aba Colaboradores​ Clique na aba Colaboradores. Aqui, você pode adicionar Agentes à caixa de entrada ou excluir Agentes já adicionados à caixa. Você também pode habilitar ou desabilitar a atribuição automática de novas conversas para os agentes adicionados a esta caixa de entrada. Clique em Atualizar para salvar as alterações. Aba Horário Comercial​ Clique na aba Horário Comercial. Nesta seção, você pode definir o horário de trabalho da sua equipe associada à caixa de entrada do Twitter. Marque a caixa de seleção Ativar disponibilidade comercial para esta caixa de entrada caso você tenha horários comerciais bem definidos. Uma vez marcada a caixa, a seção abaixo será exibida. Você pode escrever a mensagem que será exibida ao cliente fora do horário comercial. Também é possível selecionar o horário comercial disponível para cada dia da semana e o fuso horário apropriado. Clique no botão Atualizar Configuração de Horário Comercial.

Como criar um canal no Telegram?

Passo 1. Vá para Configurações → Caixas de Entrada → “Adicionar Caixa de Entrada”. Passo 2. Clique no ícone "Telegram". Passo 3. Crie um novo bot do Telegram usando o BotFather do Telegram. Passo 4. Insira o token da API do bot do Telegram e clique em "Criar Canal do Telegram". Passo 5. "Adicione agentes" à sua caixa de entrada do Telegram. A configuração da caixa de entrada está completa. Passo 6. Vá para a página de configurações da Caixa de Entrada e verifique se o nome da caixa de entrada corresponde ao nome de usuário do bot criado usando o BotFather. Passo 7. Envie uma mensagem para o bot do Telegram. Verifique a caixa de entrada do Telegram no Chatwoot para ver a nova mensagem. Perguntas Frequentes O Chatwoot suporta contas de Bot Empresarial do Telegram? Sim — o suporte para bots em modo empresarial do Telegram foi adicionado no Chatwoot v4.3.0 (18 de junho de 2025). Como habilitar Bots Empresariais? 1. No @BotFather digite /business_mode, escolha seu bot e confirme. 2. Crie uma nova caixa de entrada do Telegram no Chatwoot (Configurações → Caixas de Entrada → Adicionar Caixa de Entrada → Telegram) e cole o mesmo token do bot. 3. O Chatwoot detecta automaticamente o Modo Empresarial e registra o webhook correto. 4. Para melhores resultados, mantenha este bot empresarial em uma caixa de entrada separada, diferente de qualquer bot padrão que você já utilize.  Problemas conhecidos com o Bot Empresarial • Janela de resposta de 24 horas – O Telegram só permite que o bot (e o Chatwoot) respondam dentro de 24 horas após a última mensagem do cliente.  • Se um usuário já tiver conversado com o mesmo bot fora do Modo Empresarial, as respostas podem parecer vir do bot em vez da conta empresarial; criar um bot empresarial e uma caixa de entrada dedicados evita essa confusão. • A API Empresarial do Telegram atualmente possui menos recursos do que a API normal de bots (por exemplo, sem indicadores de digitação, tipos de mensagem limitados). Ajuste suas expectativas de acordo.

5. Conecte o WhatsApp através do Twilio

Conecte um número do WhatsApp que você gerencia no Twilio. É uma boa opção caso você já utilize o Twilio para SMS ou WhatsApp e queira manter a cobrança lá. Plano e acesso - Todo plano que inclui WhatsApp (Startups e acima, e o teste gratuito) no Chatwoot Cloud e auto-hospedado. Veja Preços e Planos. - Apenas Administradores. - Com o Twilio você pode enviar modelos (modelos de conteúdo do Twilio) e pesquisas de CSAT. Você não pode usar campanhas do WhatsApp ou chamadas de WhatsApp. Veja a tabela em WhatsApp no Chatwoot. Antes de começar - Uma conta Twilio com um remetente do WhatsApp (número) aprovado no Twilio. - Seu Account SID e Auth Token do Twilio, ou API Key SID e API Key Secret. - Opcional: um Messaging Service SID, caso envie por um Serviço de Mensagens Twilio. Para obter um, no Console do Twilio vá em Messaging › Services › Create Messaging Service, complete os passos e copie o SID do serviço. - Se você usa o Twilio Studio, não substitua seu webhook pelo Callback URL do Chatwoot. Isso interrompe o fluxo do Studio. Entre em contato com o suporte antes. Conecte seu número 1. Vá em Configurações › Caixas de Entrada › Adicionar Caixa de Entrada › WhatsApp e escolha Twilio. 2. Digite um Nome da Caixa de Entrada. 3. Digite o Número de Telefone, começando com + e sem espaços. Se você enviar por um Serviço de Mensagens, ative Usar um Serviço de Mensagens Twilio e insira o Messaging Service SID. O campo Número de Telefone fica oculto quando esta opção está ativada. Você insere um ou outro, não ambos. 4. Digite seu Account SID e, ou seu Auth Token, ou (após ativar Usar Autenticação por API Key) seu API Key SID e API Key Secret. 5. Verifique se você informou ou o Número de Telefone ou, com Usar um Serviço de Mensagens Twilio ativado, o Messaging Service SID (veja o passo 3). 6. Clique em Criar Canal Twilio e depois adicione agentes. 7. Copie o Callback URL exibido no Chatwoot e defina-o como o webhook de mensagens recebidas no Console do Twilio: - Para um número de telefone: vá em Phone Numbers › Manage › Active Numbers, clique no seu número e depois em Configure. Em Messaging, cole a URL no campo A message comes in do webhook e salve. - Para um Serviço de Mensagens: vá em Messaging › Services, selecione seu serviço, depois em Integration e cole a URL lá. Para encontrar o Callback URL depois, vá em Configurações › Caixas de Entrada, abra a sua caixa e selecione a guia Configuração. Teste: envie uma mensagem pelo WhatsApp para seu número a partir de outro telefone e verifique se chega no Chatwoot. Responda e veja se chega no telefone. O que acontece em seguida - Modelos: modelos de conteúdo do Twilio aprovados são sincronizados no Chatwoot. Veja Modelos de conteúdo do Twilio em Modelos e a janela de 24 horas.

Como criar uma caixa de entrada de canal de API?

Para criar e configurar uma caixa de entrada de canal de API em instalações do Chatwoot, siga o passo descrito abaixo. Configurar o canal de API Passo 1. Vá em Configurações → Caixas de entrada → “Adicionar Caixa de entrada”. Passo 2. Clique no ícone "API". Passo 3. Forneça um nome para o canal e uma URL de callback. Veja um exemplo: Passo 4. "Adicionar agentes" à sua caixa de entrada API. A configuração da caixa de entrada está concluída. Envie mensagens para o canal de API Para enviar mensagens para o canal de API, certifique-se de entender os seguintes modelos e a nomenclatura usada no Chatwoot. 1. Canal: Canal define o tipo de origem das conversas. Ex: Facebook, Twitter, API, etc. 2. Caixa de entrada: Você pode criar várias origens de conversas do mesmo tipo de canal. Ex: Você pode ter mais de uma página do Facebook conectada a uma conta do Chatwoot. Cada página é chamada de caixa de entrada no Chatwoot. 3. Conversa: Uma Conversa é uma coleção de mensagens. 4. Contato: Cada conversa tem uma pessoa real associada a ela, chamada de contato. 5. Contato nas caixas de entrada: Esta é a sessão de cada contato em uma caixa de entrada. Um contato pode ter várias sessões e múltiplas conversas na mesma caixa de entrada. Como enviar uma mensagem em um Canal de API? Para enviar uma mensagem em um canal de API, crie um contato, inicie uma conversa e, por fim, envie a mensagem. As APIs exigem o api_access_token no cabeçalho da requisição. Você pode obter este token visitando suas configurações de Perfil → Token de Acesso. 1. Criar um contato Ref: Documentação da API Informe o ID da caixa de entrada do canal API junto com outros parâmetros especificados. Isso criará uma sessão para você automaticamente. Uma resposta de exemplo seria semelhante à apresentada abaixo. { "email": "string", "name": "string", "phone_number": "string", "thumbnail": "string", "additional_attributes": {}, "contact_inboxes": [ { "source_id": "string", "inbox": { "id": 0, "name": "string", "website_url": "string", "channel_type": "string", "avatar_url": "string", "widget_color": "string", "website_token": "string", "enable_auto_assignment": true, "web_widget_script": "string", "welcome_title": "string", "welcome_tagline": "string", "greeting_enabled": true, "greeting_message": "string" } } ], "id": 0, "availability_status": "string" } Como você pode ver no payload, será possível visualizar contact_inboxes e cada contact_inbox terá um source_id. O Source ID pode ser visto como o identificador da sessão. Você usará este source_id para criar uma nova conversa conforme definido abaixo. 2. Criar uma conversa Ref: Documentação da API Use o source_id recebido na chamada de API anterior. Você receberá um ID de conversa, que pode ser usado para criar uma mensagem. { "id": 0 } 3. Criar uma nova mensagem Ref: Documentação da API Existem 2 tipos de mensagens. 1. Recebida: Mensagens enviadas pelo usuário final são classificadas como mensagens recebidas. 2. Enviada: Mensagens enviadas pelo agente são classificadas como mensagens enviadas. Se você chamar a API com o conteúdo correto, receberá um payload semelhante a este: { "id": 0, "content": "Esta é uma mensagem recebida do Canal API", "inbox_id": 0, "conversation_id": 0, "message_type": 0, "content_type": null, "content_attributes": {}, "created_at": 0, "private": false, "sender": { "id": 0, "name": "Pranav", "type": "contact" } } Se tudo ocorrer com sucesso, você verá a conversa no painel da seguinte forma. Você será notificado quando uma nova mensagem for criada na URL informada durante a criação do canal de API. Você pode ler sobre o payload da mensagem aqui. Receber mensagens usando a URL de callback Quando uma nova mensagem é criada no canal de API, você receberá uma requisição POST para a URL de Callback informada durante a criação do canal de API. O payload será semelhante a este. Encontre a lista completa de eventos suportados pelo webhook aqui. Tipo de evento: message_created { "id": 0, "content": "Esta é uma mensagem recebida do Canal API", "created_at": "2020-08-30T15:43:04.000Z", "message_type": "incoming", "content_type": null, "content_attributes": {}, "source_id": null, "sender": { "id": 0, "name": "contact-name", "avatar": "", "type": "contact" }, "inbox": { "id": 0, "name": "API Channel" }, "conversation": { "additional_attributes": null, "channel": "Channel::Api", "id": 0, "inbox_id": 0, "status": "open", "agent_last_seen_at": 0, "contact_last_seen_at": 0, "timestamp": 0 }, "account": { "id": 1, "name": "API testing" }, "event": "message_created" } Criar interfaces usando Client APIs As APIs de cliente disponíveis para o canal de API vão ajudar você a construir interfaces voltadas para o cliente do Chatwoot. Essas APIs são úteis para situações como as listadas abaixo. 1. Usar uma interface de chat personalizada ao invés do widget padrão do Chatwoot. 2. Construir interfaces conversacionais em seus aplicativos móveis. 3. Adicionar o Chatwoot a outras plataformas para as quais o Chatwoot não possui um SDK oficial. Criando objetos de cliente Você pode criar e recuperar objetos de dados de clientes usando o inbox_identifier e o customer_identifier. Identificador da Caixa de Entrada Você pode obter o inbox_identifier em seu canal de API -> Configurações -> Configuração. Identificador do Cliente O customer_identifier ou o source_id pode ser obtido ao criar o cliente usando a API de criação. Você precisará armazenar este identificador no lado do cliente para fazer futuras solicitações em nome do cliente. Isso pode ser feito em cookies, local storage, etc. APIs Disponíveis As Client APIs disponíveis estão documentadas aqui. Algumas das ações que você pode executar com as APIs: - Criar, Visualizar e Atualizar Contato - Criar e Listar Conversas - Criar, Listar e Atualizar Mensagens Autenticação HMAC As Client APIs também suportam Autenticação HMAC. O token HMAC para o Canal pode ser obtido executando o seguinte no seu console rails. # substitua api_inbox_id pelo id da sua caixa de entrada Inbox.find(api_inbox_id).channel.hmac_token Conectando aos WebSockets do Chatwoot Para obter atualizações em tempo real do painel do agente, conecte-se aos WebSockets do Chatwoot utilizando a seguinte URL. <your installation url>/cable Autenticando sua conexão WebSocket Após assinar utilizando o pubsub_token do cliente, você receberá eventos direcionados ao seu objeto de cliente. O pubsub_token é fornecido durante a chamada da API de criação do cliente. Exemplo const connection = new WebSocket('ws://localhost:3000/cable'); connection.send(JSON.stringify({ command:"subscribe", identifier: "{\\"channel\\":\\"RoomChannel\\",\\"pubsub_token\\":\\""+ customer_pubsub_token+"\\"}" })); Encontre a lista completa de eventos suportados por WebSockets aqui. Verificação de Webhook Assim que você cria um canal de API, é gerado automaticamente um segredo que você pode usar para verificar o payload que sua aplicação recebe. Saiba mais sobre verificação de webhook aqui. Implementação Aqui está um exemplo de interface de chat construída sobre as Client APIs.

4. Conectar com a API em Nuvem do WhatsApp (configuração manual)

Use a configuração manual se o seu número já estiver na Plataforma WhatsApp Business (API), se você é um provedor de tecnologia configurando seu próprio número, se está com hospedagem própria ou se a Configuração rápida não está disponível. Você conecta o Chatwoot ao seu próprio app Meta. Plano & acesso - Todo plano que inclui WhatsApp (Startups e superiores, e o teste gratuito) no Chatwoot Cloud e auto-hospedado. Veja Preços & Planos. - Apenas para Administradores. - A coexistência (manter o app WhatsApp Business) não é suportada com a configuração manual. Se o seu número estiver ativo no app WhatsApp Business, não o registre por este fluxo. Use a Configuração rápida (página 3) ou entre em contato com o suporte. Antes de começar Você precisa de três itens do Meta. O assistente de configuração do Chatwoot orienta você por cada um e fornece links para a tela correta do Meta: - Um app Meta com o caso de uso WhatsApp - O ID do número de telefone e o ID da Conta WhatsApp Business do seu número - Um token de acesso permanente de um usuário do sistema Meta Conecte seu número 1. Vá em Configurações › Caixas de entrada › Adicionar caixa de entrada › WhatsApp e escolha WhatsApp Cloud. Na tela de Configuração rápida, clique em fluxo de configuração manual na parte inferior. (Se a Configuração rápida não estiver disponível, você vai direto para a configuração manual.) 2. Crie ou selecione um app Meta. No Meta Developers, crie um app (ou escolha um que já use para esse número), opte por conectar com os clientes via WhatsApp e selecione o portfólio empresarial que possui o número. Clique em Meu app Meta está pronto. 3. Adicione seu número de telefone e obtenha seus IDs. No seu app Meta, abra o caso de uso WhatsApp e escolha Configuração da API. Em Enviar e receber mensagens, abra o seletor De e escolha seu número, ou selecione Adicionar número de telefone, preencha o perfil da empresa e faça a verificação com o código enviado pelo Meta. Copie o ID do número de telefone e o ID da Conta WhatsApp Business, insira-os no Chatwoot e clique em Próximo. 4. Gere um token de acesso permanente. Nas Configurações de Negócios do Meta, acesse Usuários › Usuários do sistema, crie um usuário admin do sistema (ou escolha um já existente), atribua seu app Meta e Conta WhatsApp Business com controle total, depois clique em Gerar token. Defina a expiração para Nunca, selecione whatsapp_business_management e whatsapp_business_messaging, e copie o token. O Meta mostra o token apenas uma vez. De volta ao Chatwoot, cole-o como Token de acesso permanente e clique em Verificar detalhes. 5. Revise o nome da empresa, o número e os IDs, altere o Nome da caixa de entrada se desejar, e clique em Criar caixa de entrada. 6. O Chatwoot verifica Acesso ao número, Acesso a modelos, Callback do webhook e Inscrição do webhook, e configura o webhook no Meta para você. Quando os quatro mostrarem Verificado, clique em Continuar para adicionar agentes. Teste: envie uma mensagem WhatsApp para seu número comercial a partir de outro telefone. Ela deve aparecer no Chatwoot. Responda e confira se a mensagem chega. Mantenha seu token privado. Qualquer pessoa com ele pode usar sua conexão WhatsApp. Se você substituí-lo ou revogá-lo no Meta, atualize-o na aba Configuração da caixa de entrada. Se uma etapa de verificação falhar | Mensagem | O que fazer | | -------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | Este token de acesso é inválido ou expirou | Gere um novo token permanente (expiração Nunca) e tente novamente | | Acesso ao modelo não verificado | O token está sem whatsapp_business_management. As mensagens funcionarão, mas os modelos não serão sincronizados. Gere um token com as duas permissões. | | Callback do webhook ou Inscrição do webhook não verificado | Clique em Tentar configurar webhook novamente. Se continuar falhando, verifique se o usuário do sistema tem controle total da Conta WhatsApp Business. | | Digite o ID do número de telefone e o ID da Conta WhatsApp Business | Copie ambos de Configuração da API no seu app Meta. São números diferentes. | Para qualquer outra situação, veja Soluções de problemas do WhatsApp. O que acontece depois - Modelos aprovados na sua Conta WhatsApp Business são sincronizados automaticamente. Veja Modelos e a janela de 24 horas. - Chamadas funcionam com configuração manual também, depois que seu número estiver habilitado na API de Chamadas do Meta. Veja Chamadas WhatsApp. Conectando mais de um número Sim, você pode. Crie uma caixa de entrada Chatwoot separada para cada número. O assistente de configuração faz o roteamento do webhook para cada uma, então não há necessidade de ajustes manuais.

Como configurar um canal de e-mail?

Para gerenciar seu e-mail de suporte ao cliente/atendimento por tickets a partir do Chatwoot, você pode criar uma Caixa de Entrada de E-mail no Chatwoot. Este é um guia completo para colocar seu canal de e-mail funcionando. Este documento está dividido em três partes: 1. Criando uma caixa de entrada de E-mail 2. Configurações para usuários do Gmail 3. Criando uma caixa de entrada de E-mail da Microsoft Fique à vontade para ir diretamente a qualquer seção. Vamos começar. Como criar uma caixa de entrada de E-mail no Chatwoot? Passo 1. Abra seu painel do Chatwoot. Vá para Configurações → Caixas de Entrada → Adicionar Caixa de Entrada. Passo 2. Clique no ícone "Email". Passo 3. Digite o nome do canal (como você gostaria de identificar este canal), seu e-mail de suporte e clique no botão "Criar Canal de E-mail". P.S. Você também verá uma opção para selecionar Microsoft como provedor de e-mail. Se você usa um e-mail Outlook/Microsoft, vá para a seção "Como criar um canal de E-mail da Microsoft?" (última seção). Passo 4. "Adicione agentes" à sua caixa de entrada de e-mail. Você criou com sucesso uma caixa de entrada de E-mail. Passo 5. Configure as suas definições de e-mail. Vá para Configurações → Caixas de Entrada → Configurações da Caixa de Entrada de E-mail → Aba Configuração. Você verá três configurações principais aqui: 1. Encaminhar para E-mail 2. Configurar IMAP 3. Configurar SMTP Todas as três opções são explicadas nas seções a seguir. Como encaminhar e-mails para a caixa de entrada do Chatwoot? Passo 1. Copie o "Endereço de e-mail para encaminhamento" da aba Configuração da caixa de entrada. Passo 2. Configure o endereço de e-mail copiado como o endereço de encaminhamento na caixa de entrada de e-mail. P.S. Confira a seção do Gmail abaixo para saber como adicionar um endereço de encaminhamento no Gmail. Passo 3. Envie um e-mail para o endereço de encaminhamento inserido e verifique a caixa de entrada de e-mail do Chatwoot para o novo e-mail. Como configurar IMAP para o canal de E-mail? Se você está usando Gmail, desça até a seção de IMAP para Gmail abaixo. Passo 1. Vá para Configurações → Caixas de Entrada → Configurações da Caixa de Entrada de E-mail → Aba Configuração. Passo 2. Marque a caixa Habilitar configuração IMAP para esta caixa de entrada. Você verá os campos necessários conforme abaixo. 1. Endereço 2. Porta 3. E-mail 4. Senha P.S. Se estiver usando Gmail com 2FA habilitado, desça até a seção "Como gerar senha de app para Gmail?". Se estiver usando uma conta Gmail convencional, desça até "Como permitir acesso menos seguro ao Gmail?". Passo 3. Teste se tudo está funcionando corretamente. Envie um e-mail para o e-mail configurado com IMAP no Chatwoot. Verifique a caixa de entrada do Chatwoot para o novo e-mail. Abra a conversa de e-mail no Chatwoot e confira os detalhes do e-mail. Como configurar SMTP para o canal de E-mail? Passo 1. Vá para Configurações -> Caixas de Entrada -> Página de configurações da Caixa de Entrada de E-mail. Passo 2. Selecione a aba "Configuração". Passo 3. Para habilitar SMTP, marque a caixa "Habilitar configuração SMTP para esta caixa de entrada". Preencha os campos abaixo e clique no botão "Atualizar configurações SMTP". 1. Endereço 2. Porta 3. E-mail 4. Senha P.S. Se estiver usando Gmail com 2FA habilitado, desça até "Como gerar senha de app para Gmail?". Se estiver usando uma conta convencional do Gmail, veja "Como permitir acesso menos seguro ao Gmail?". 5. Domínio Passo 4. Abra uma conversa de e-mail existente no Chatwoot. Passo 5. Digite uma mensagem de resposta para a conversa e clique no botão "Enviar". Confira se o e-mail foi entregue. Você também pode checar a caixa de entrada do destinatário para o e-mail entregue. Configurações para usuários do Gmail Como habilitar IMAP para caixa de entrada do Gmail? Passo 1. Abra sua caixa de entrada do Gmail e clique no ícone de configurações no canto superior direito. Clique no botão "Ver todas as configurações". Passo 2. Selecione a aba "Encaminhamento e POP/IMAP" na página de configurações. Passo 3. Escolha a opção "Ativar IMAP" na seção de acesso IMAP e clique no botão "Salvar alterações". Como permitir acesso menos seguro ao Gmail? Nota: Esta opção não está disponível para contas Gmail com verificação em duas etapas habilitada ou gerenciadas por uma organização. Passo 1. Acesse Google Account Security. Passo 2. Clique em "Ativar acesso" em "Acesso a apps menos seguros" na página de Segurança. Passo 3. Ative "Permitir apps menos seguros". Agora você pode utilizar a senha da sua conta Gmail para configurar IMAP/SMTP. Como gerar senha de app para Gmail? Nota: Esta opção é para contas Gmail com verificação em duas etapas habilitada ou gerenciadas por uma organização. Passo 1. Acesse Google Account Security. Passo 2. Clique em "Senhas de apps" em "Fazendo login no Google" na página de Segurança. Passo 3. Selecione o app Mail, selecione um dispositivo e clique em "GERAR". Use a senha gerada para configurar IMAP/SMTP. Como adicionar um endereço de encaminhamento para Gmail? Passo 1. Abra sua caixa de entrada do Gmail e clique no ícone de configurações no canto superior direito. Clique no botão "Ver todas as configurações". Passo 2. Selecione a aba "Encaminhamento e POP/IMAP" na página de configurações. Passo 3. Clique no botão "Adicionar um endereço de encaminhamento". Será solicitado o endereço de e-mail para encaminhamento. Digite o do Chatwoot e clique no botão "Próxima". Passo 4. Confirme o endereço de encaminhamento na janela do navegador. A caixa de entrada de e-mail enviará um código de verificação para o endereço de encaminhamento. Passo 5. Copie o código de verificação da caixa de entrada de e-mail do Chatwoot. Passo 6. Cole o código de verificação e clique no botão "Verificar". Passo 7. Selecione a opção "Encaminhar uma cópia dos e-mails recebidos". Escolha a ação desejada no segundo menu e clique no botão "Salvar alterações". Como criar um canal de E-mail da Microsoft? Passo 1. Abra seu painel do Chatwoot. Vá para Configurações → Caixas de Entrada → Adicionar Caixa de Entrada. Passo 2. Clique no ícone "Email". Passo 3. Clique no ícone "Microsoft". Passo 4. Adicione seu e-mail Outlook/Microsoft. Passo 5. Digite as credenciais da sua conta Microsoft/Outlook. Passo 6. Permita que o app "Chatwoot" leia e responda seus e-mails. Passo 7. "Adicione agentes" à sua caixa de entrada de e-mail. Você criou com sucesso uma caixa de entrada de E-mail da Microsoft. Passo 5. Configure suas configurações de e-mail. Vá para Configurações → Caixas de Entrada → Configurações da Caixa de Entrada de E-mail → Aba Configuração. Nota: Por favor, não altere nada nas Configurações por enquanto, pois utilizamos os valores padrão para IMAP e SMTP. Em breve, tornaremos esses campos não editáveis para contas do Outlook. Utilizamos as configurações IMAP padrão para buscar e-mails e SMTP para envio; você não precisa definir nada na configuração. Passo 6. Se seu token de acesso expirar, será necessário reautorizar sua conta Microsoft acessando Configurações -> Configuração.

Como configurar um canal no Facebook?

Se você está usando uma instalação Chatwoot auto-hospedada, por favor configure seu aplicativo do Facebook conforme descrito neste guia. Para a versão em nuvem do Chatwoot, siga as etapas abaixo. Passo 1. Vá em Configurações → Caixas de Entrada → “Adicionar Caixa de Entrada”. Passo 2. Clique no ícone "Messenger". Passo 3. Clique no botão de login do Facebook. Uma nova janela será aberta para você fazer login. Passo 4. Autentique-se com o Facebook e selecione a página que deseja conectar. Habilite todas as permissões exibidas na lista. Isso ajudará o Chatwoot a realizar todas as ações desejadas sem problemas. Passo 5. Agora você pode selecionar sua página do Facebook no menu suspenso que aparece no Chatwoot. Passo 6. "Adicione agentes" à sua caixa de entrada do Facebook. Você criou com sucesso uma caixa de entrada do Facebook. Sempre que um cliente enviar uma mensagem para sua página do Facebook, você poderá visualizá-la e respondê-la no Chatwoot. Configurações adicionais da Caixa de Entrada​ Sua caixa de entrada do Facebook recém-configurada deverá aparecer agora na sua lista de caixas de entrada. Para visualizar isso e fazer configurações adicionais na sua caixa de entrada do Facebook, vá em Configurações → Caixas de Entrada → clique no ícone de engrenagem na caixa de entrada do Facebook correspondente. Você verá a seguinte tela: Aba Configurações​ Ativar saudação do canal. Assim que você ativar isso, o Chatwoot enviará uma mensagem de saudação para novas conversas criadas através da sua caixa de entrada do Facebook. Ativar CSAT. Quando habilitado, sua pesquisa de Satisfação do Cliente será lançada toda vez que um chamado for resolvido. Os resultados do CSAT podem ser visualizados posteriormente na seção Relatórios. Reautorizar. Sempre que precisar reconectar e reautorizar sua página do Facebook, faça isso por este botão. Aba Colaboradores​ Clique na aba Colaboradores. Aqui, você pode adicionar Agentes à Caixa de Entrada ou remover Agentes que já foram adicionados à Caixa de Entrada. Você também pode habilitar ou desabilitar a atribuição automática de novas conversas para os agentes adicionados a essa caixa de entrada. Clique em Atualizar para salvar as alterações. Aba Horário Comercial​ Clique na aba Horário Comercial. Nesta seção, você pode definir o horário de trabalho de sua equipe associada à caixa de entrada do Facebook. Clique na caixa de seleção Habilitar disponibilidade comercial para esta caixa de entrada se você possui horários comerciais bem definidos. Assim que a caixa for marcada, a seção abaixo se abrirá. Você pode escrever a mensagem que será exibida ao cliente fora do horário comercial. Nota: Quando o Captain está habilitado em uma caixa de entrada, a mensagem de indisponibilidade é automaticamente suprimida. O Captain irá lidar com as conversas diretamente, mesmo fora do horário comercial. A mensagem de indisponibilidade só será enviada se o Captain transferir a conversa para um agente humano ou se o Captain não estiver configurado para a caixa de entrada. Você também pode selecionar o horário comercial disponível para cada dia da semana, juntamente com o fuso horário apropriado. Clique no botão Atualizar Configuração de Horário Comercial.