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.

Como criar um canal no WhatsApp?

Você pode gerenciar as conversas da sua Conta Comercial do WhatsApp diretamente pelo Chatwoot. Para conectar seu número do WhatsApp, o Chatwoot oferece dois métodos de integração: - Cadastro Integrado (recomendado) – um fluxo guiado fornecido pela Meta que configura automaticamente seu número, webhooks e tokens. - Configuração Manual – uma opção avançada para provedores de tecnologia e casos em que o Cadastro Integrado não pode ser utilizado. Este guia oferece uma visão geral dos dois métodos, suas diferenças e links para instruções completas passo a passo. Pré-requisitos - Uma conta de desenvolvedor ou comercial da Meta (Facebook) - Um número de telefone válido (não atrelado a outro fluxo de Cadastro Integrado do WhatsApp, salvo em caso de migração) - Um workspace do Chatwoot com a funcionalidade WhatsApp habilitada Etapa 1: Vá para Caixas de Entrada 1. Entre na sua conta do Chatwoot. 2. Acesse Configurações › Caixas de Entrada › Adicionar Caixa de Entrada. 3. Escolha WhatsApp como canal. Etapa 2: Escolha seu Método de Configuração Ao criar uma Caixa de Entrada do WhatsApp, você verá duas opções: Conectar com WhatsApp Business (Cadastro Integrado) - Redireciona você para o fluxo de Cadastro Integrado da Meta. - Você faz login com sua conta do Facebook, seleciona ou cria uma Conta Comercial do WhatsApp (WABA) e adiciona o número do telefone. - O Chatwoot recebe automaticamente o webhook, os tokens e a configuração do número de telefone. Use esta opção se você está: - Adicionando um novo número do WhatsApp - Procurando a configuração mais rápida e sem ajustes - Não é um provedor de tecnologia integrando o próprio número Leia o guia completo do Cadastro Integrado do WhatsApp Configuração Manual - Você configura tudo pelo Console de Desenvolvedor da Meta. - Requer geração de tokens, criação de usuário de sistema, associação de ativos e configuração manual dos webhooks. - Você copia/cola o ID do Número de Telefone, o ID da Conta Comercial e a chave da API no Chatwoot. Use esta opção se você é: - Um provedor de tecnologia integrando o próprio número - Reutilizando um número que já está associado ao Cadastro Integrado - Confortável trabalhando com o painel de desenvolvedor da Meta Leia o guia completo da Configuração Manual

Como configurar um canal do WhatsApp (Cadastro incorporado)

O que é o Cadastro Incorporado do WhatsApp? O Cadastro Incorporado é uma interface baseada no navegador fornecida pela Meta que autentica um usuário do Facebook, cria (ou vincula) uma Conta Comercial do WhatsApp (WABA), adiciona um número de telefone e retorna credenciais de produção em um único fluxo. O Chatwoot Cloud incorpora essa interface quando você escolhe WhatsApp Cloud ao adicionar uma Caixa de Entrada, portanto, não são necessários tokens manuais ou URLs de webhook. Pré-requisitos em resumo - Login no Facebook (Meta) - Informações empresariais - Espaço de trabalho do Chatwoot Cloud com o recurso WhatsApp ativado Fluxo de integração dentro do Chatwoot Passo 1. Vá em Configurações → Caixas de Entrada → “Adicionar Caixa de Entrada”. Selecione WhatsApp. Passo 2. Clique no botão "Conectar com o WhatsApp Business". Passo 3. Inicie o fluxo da Meta. Faça login com a conta do Facebook que irá gerenciar o WABA. Forneça os dados da empresa ou selecione um portfólio existente, depois escolha um WABA existente ou crie um novo. Passo 4. "Adicione agentes" à sua caixa de entrada do Instagram. Dica: Use uma aba dedicada do navegador e desative bloqueadores de anúncios; as janelas OAuth da Meta dependem de cookies de terceiros Pontos de verificação de conformidade 1. Verificação empresarial: Envie documentos legais caso a Meta solicite durante ou após o cadastro 2. Revisão do nome exibido: Certifique-se de que o nome exibido no WhatsApp segue as diretrizes de marca para evitar reprovação

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.

Como configurar um canal do WhatsApp com o Twilio?

Gerencie as conversas da sua conta comercial do WhatsApp através do Chatwoot. Você tem duas opções de provedores: 1. WhatsApp Cloud API (modo preferido) 2. Twilio Este guia irá orientá-lo pelo processo de configuração. Pré-requisitos 1. Um número de telefone válido 2. Uma conta Twilio. Se você ainda não tem uma, crie aqui: https://www.twilio.com/en-us/messaging/channels/whatsapp Usando a API do Twilio Existem duas maneiras de usar o Twilio com o Chatwoot: 1. Maneira comum, sem serviço de mensagens 2. Com serviço de mensagens Configurando o Twilio Sem Serviço de Mensagens Acesse sua conta Twilio e clique em "Create New Account" Complete todos os campos obrigatórios e finalize o processo de criação da conta Copie seu Account SID, Auth Token e número de telefone. Se você ainda não adicionou um número de telefone à sua conta Twilio, faça isso antes de prosseguir. Acesse sua conta Chatwoot, clique em Configurações > Caixa de entrada > Adicionar Caixa de Entrada e selecione Whatsapp Digite seu Account SID, Auth Token e número do WhatsApp aqui Adicione agentes para gerenciar sua caixa de entrada do WhatsApp Vá para Configurações > Caixa de entrada, selecione sua caixa, clique em Configuração e copie sua URL de webhook Volte para o painel do Twilio 1. Vá para Twilio Console → Phone Numbers → Manage → Active Numbers 2. Clique no seu número do WhatsApp. 3. Clique em Configure 4. Em Messaging, procure o campo “Webhook (When a message comes in)”. 5. Atualize a URL do webhook. Pronto! Agora você pode começar a enviar mensagens do WhatsApp pelo Chatwoot. Configurando o Twilio com Serviço de Mensagens Configurar o Twilio com um serviço de mensagens requer etapas adicionais em comparação à configuração comum. Navegue até Messaging > Services e clique no botão "Create Messaging Service". Preencha todos os campos obrigatórios nas etapas seguintes até chegar aqui. Copie seu ID do serviço de mensagens e clique em “Save”. Acesse sua conta Chatwoot. Ao criar uma caixa de entrada, marque a caixa "Use Twilio Message Service". Em seguida, cole seu Account ID, Message Service ID e Token nos campos apropriados. Vá até o painel do Twilio, navegue até Messaging > Services > Select Service > Integration e cole sua URL de Webhook aqui. Pronto—tudo certo! Agora você pode começar a enviar mensagens do WhatsApp pelo Chatwoot. FAQ’s Quais tipos de modelos do WhatsApp o Chatwoot suporta ao usar Twilio? Atualmente, o Chatwoot não suporta modelos com Twilio. Estou usando o Twilio Studio. São necessárias etapas adicionais para fazê-lo funcionar? Se você usar o Twilio Studio para um fluxo de conversa personalizado, atualizar a URL do webhook diretamente irá quebrar sua integração existente. Siga estas etapas em vez disso: 1. Identifique o passo do seu fluxo onde deseja que aconteça a “transferência para o agente”. 2. Adicione um “widget de requisição http” conforme mostrado abaixo com os valores fornecidos. 3. Certifique-se de que o seu fluxo possa lidar com as respostas dos usuários às respostas dos agentes.

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.

Como configurar um canal do WhatsApp (Fluxo manual)?

Você pode gerenciar as conversas da sua conta empresarial do WhatsApp pelo Chatwoot. Para configurar, você tem duas opções para escolher seu provedor: 1. WhatsApp Cloud API 2. Twilio Explicaremos todos os procedimentos neste guia. Pré-requisitos 1. Você precisa de uma Conta de Desenvolvedor Meta para configurar a API do WhatsApp. Se ainda não tem uma conta de desenvolvedor, clique aqui para criar uma antes de prosseguir. 2. Um número de telefone válido Usando o Whatsapp Cloud API O WhatsApp Cloud API está disponível para todas as empresas e desenvolvedores individuais. Como é hospedado na infraestrutura em nuvem da Meta, você não precisa mais usar provedores terceirizados como Twilio, Zendesk, 360Dialog ou MessageBird (Business Solution Providers) para hospedar sua API do WhatsApp Business. Configure seu Perfil Empresarial Crie um perfil profissional do WhatsApp Business com o nome da sua empresa, descrição e informações de contato. Um perfil bem elaborado ajuda os clientes a reconhecerem e confiarem na sua marca ao interagir com você. Faça login em https://business.facebook.com e clique no botão criar portfólio no menu suspenso em "Início" Preencha todos os campos obrigatórios para configurar seu portfólio empresarial. Depois de criar seu portfólio empresarial, é hora de criar seu aplicativo do Facebook. Configure seu Aplicativo do Facebook Faça login em https://developers.facebook.com/ e clique no botão Criar Aplicativo. Preencha os campos obrigatórios Clique em "Outro" entre as opções Escolha "Business" como o tipo do seu aplicativo Digite seu e-mail de contato e selecione seu portfólio empresarial no menu suspenso. Adicionar Whatsapp ao seu aplicativo Após criar seu aplicativo, você será direcionado ao painel do aplicativo. Lá, clique em "Adicionar Produto" e escolha WhatsApp na lista de produtos disponíveis. Clique no botão "Configurar" para o WhatsApp Nota: Antes de prosseguir, verifique sua empresa com a Meta. Você precisará enviar documentação para verificação, o que é obrigatório para acesso completo à API. Configure um Token de Acesso Permanente para o WhatsApp Cloud API Você precisará criar um Usuário do Sistema e gerar um token permanente para manter o acesso seguro e ininterrupto. Faça login na sua conta de desenvolvedor do Facebook, selecione seu aplicativo do WhatsApp e vá até a página de configurações do negócio. Clique em "Usuários do sistema" e adicione um novo usuário do sistema com o papel Admin Clique no botão "Adicionar Ativos", selecione o nome do seu aplicativo, escolha a opção "Controle Total" e clique em "Atribuir ativos." Volte para a página de usuários do sistema, selecione seu novo usuário na lista e clique no botão "Gerar novo token". Selecione seu aplicativo no menu suspenso Selecione estes três níveis de permissão para seu token: - whatsapp_business_manage_events - whatsapp_business_management - whatsapp_business_messaging Copie e salve seu token Configure o WhatsApp Cloud API Para criar uma nova conta empresarial Meta, selecione "criar uma conta empresarial" no menu suspenso. Se você já possui uma conta empresarial, pode selecioná-la nas opções existentes. Estou selecionando "criar uma conta empresarial". Clique no botão continuar. Cole seu token permanente aqui Adicione seu número de telefone de produção Nota: A Meta exige um número de telefone verificado para a configuração da API do WhatsApp. Você pode verificar seu número usando um OTP (senha única). Depois de adicionar e verificar seu número de telefone, o próximo passo é configurar um webhook para receber mensagens recebidas. Conectando sua Conta Chatwoot Vamos conectar sua conta do Chatwoot à sua Cloud API do WhatsApp Copie seu WhatsApp Phone Number ID e Business Account ID nesta seção Faça login na sua conta Chatwoot, vá em Configurações > Caixa de Entrada e selecione o canal WhatsApp Informe seu número de telefone, phone number ID e business ID do seu setup do WhatsApp API Adicione membros da equipe à sua caixa de entrada do WhatsApp Copie a URL do webhook e o token de verificação do webhook fornecidos aqui Configure seu Webhook Precisamos configurar o webhook do WhatsApp para receber mensagens de clientes enviadas para seu número empresarial. Sua URL de callback deve estar no formato https://app.chatwoot.com/webhooks/whatsapp/{phone_number}. Faça login na sua conta de desenvolvedor do Facebook e navegue até WhatsApp > Configuração Cole sua URL do webhook do Chatwoot e o token de verificação aqui, depois clique em "Verificar e Salvar" Configure permissões do webhook assinando mensagens Pronto—tudo certo! Agora você já pode começar a enviar mensagens do WhatsApp pelo Chatwoot. Perguntas Frequentes Como configurar múltiplos números em um único aplicativo do Facebook? O aplicativo do Facebook permite configurar apenas um endpoint de Webhook. Portanto, crie Caixas de Entrada no Chatwoot para todos os números necessários. Você precisará configurar a URL do Webhook fornecida para apenas uma dessas caixas de entrada no aplicativo do Facebook para que todas as outras funcionem. Que tipo de modelos de Whatsapp são suportados pelo Chatwoot? Confira a documentação para mais detalhes sobre modelos. Quais tipos de mídia são suportados?

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.