Canais de atendimento

O que são caixas de entrada

Use este guia quando você precisar configurar, entender ou validar O que são caixas de entrada na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado Um canal é um tipo de comunicação — site, e-mail, WhatsApp, SMS, etc. Uma caixa de entrada é uma instância específica de um canal conectado à sua conta. Você pode ter várias caixas de entrada do mesmo tipo de canal – por exemplo, uma caixa de entrada do site para seu site de marketing e outra para sua central de ajuda, ou dois números de WhatsApp para regiões diferentes. Cada conversa na IAra fica dentro de uma caixa de entrada. As caixas de entrada trazem seus próprios agentes, horário comercial, saudações, formulário pré-chat e regras de roteamento. Onde configurar: Configurações → Caixas de entrada → Adicionar caixa de entrada abre o seletor de canais. Escolha o tipo de canal, preencha as credenciais/configurações, adicione agentes e finalize. Na tela: Em Configurações > Caixas de entrada, clique em Adicionar Caixa de Entrada para escolher o canal que será conectado. adicionar caixa de entrada. Os tipos de canais Site (widget de chat ao vivo) Na tela: Ao criar uma caixa do tipo Site, confira a caixa e o canal antes de instalar o widget no site. site. E-mail Para lidar com e-mail de suporte dentro da IAra. Você pode conectar uma caixa de correio do Gmail ou do Google conta fazendo login no Google, uma caixa de correio do Microsoft 365 fazendo login na Microsoft ou qualquer outro provedor de e-mail inserindo manualmente os detalhes do servidor de e-mail de entrada e saída. Facebook Mensageiro Para receber e responder mensagens diretas enviadas para sua página do Facebook. Faça login no Facebook através da IAra, escolha a página da qual deseja enviar mensagens e pronto. A partir de então, cada Page DM chega ao seu painel como uma conversa, pronta para sua equipe responder junto com seus outros canais. ###Instagram (DM) Para mensagens diretas do Instagram. Conecte sua conta Instagram Business por meio do fluxo de login Meta – normalmente por meio da página do Facebook vinculada à sua conta do Instagram. Uma vez conectados, seus IG DMs fluem para a IAra com o mesmo fluxo de trabalho de resposta, etiqueta e atribuição de qualquer outro canal. ###TikTok Para mensagens TikTok Business. Faça login em sua conta TikTok Business por meio do fluxo de conexão da IAra e as mensagens dos clientes no TikTok chegarão à sua caixa de entrada da IAra. ###WhatsApp Na tela: Para WhatsApp, confira se a caixa criada corresponde ao número que será usado no atendimento. WhatsApp. ###SMS Para conversas por mensagem de texto. IAra oferece suporte a dois provedores de SMS: - Twilio — conecte seu número de telefone da Twilio e as credenciais que a Twilio fornece para mensagens. - Bandwidth — conecte seu número de telefone do Bandwidth e as credenciais que o Bandwidth lhe fornece. Depois de configurado, os textos dos clientes chegam ao seu painel à medida que as conversas e as respostas enviadas pela sua equipe são entregues como SMS para o telefone do cliente. Telegrama Para um bot do Telegram. Crie um bot no Telegram conversando com BotFather (bot oficial do Telegram para criação de bots), copie o token de bot fornecido e cole-o na IAra. Sua caixa de entrada agora recebe todas as mensagens que um cliente envia ao seu bot. LINHA Para uma conta oficial do LINE. Obtenha as credenciais do seu canal dos desenvolvedores do LINE, cole-as na IAra e as mensagens dos clientes na sua conta do LINE chegarão como conversas. Canal API Para qualquer coisa que não seja um dos tipos de canais integrados. O canal API permite conectar um aplicativo personalizado – por exemplo, uma plataforma de mensagens de nicho que a IAra ainda não oferece suporte nativo ou uma experiência de bate-papo no produto dentro de seu próprio software. Você fornece um URL de destino para onde a IAra deve enviar mensagens de saída, e seu aplicativo é responsável por retransmiti-las adiante. Opções comuns no nível da caixa de entrada Algumas opções se aplicam à maioria dos canais e estão disponíveis nas guias Configurações ou Configuração: - Atribuição automática — quando ativada, novas conversas são distribuídas aos agentes da caixa de entrada. Consulte Atribuição automática. - Bloquear para conversa única — para canais que não possuem threading nativo (SMS, WhatsApp, Facebook, Instagram, API, LINE, TikTok, Telegram), habilitar isso significa que cada contato tem no máximo uma conversa aberta por vez. Novas mensagens reabrem a conversa existente em vez de criar uma nova. - Continuidade via e-mail — para caixas de entrada de sites, os clientes podem responder às transcrições de e-mail e receber as respostas na mesma conversa. - Nome do remetente — escolha entre Amigável (apenas o nome de exibição do agente) ou Profissional (nome de exibição + nome comercial) em mensagens enviadas. - Saudação — alternar e enviar mensagem; a saudação é enviada automaticamente quando uma nova conversa começa nesta caixa de entrada. Perguntas frequentes Posso ter mais de uma caixa de entrada do mesmo tipo? Sim. Várias caixas de entrada de sites, vários números de WhatsApp, vários endereços de e-mail – sem limite de tipo. Um agente não vê a caixa de entrada na fila. Por quê? A associação à caixa de entrada é explícita. Adicione-os na guia Colaboradores. Adicionar um agente à sua conta não dá acesso automático a todas as caixas de entrada. O que acontece se eu excluir uma caixa de entrada? A caixa de entrada e todas as suas conversas são removidas permanentemente. Exporte tudo o que você precisa manter primeiro. A exclusão é irreversível. As conversas são do mesmo contato em todos os canais? Um único contato pode ter conversas em vários canais — o registro do contato abrange toda a conta. A conversa fica dentro da caixa de entrada em que a mensagem chegou, mas você verá todas as conversas do contato em seu perfil. Quais canais oferecem suporte a campanhas outbound? As campanhas de chat ao vivo funcionam nas caixas de entrada do site. Campanhas pontuais podem usar SMS ou WhatsApp Cloud API. Próximas etapas Encontre as etapas detalhadas para configurar cada canal abaixo. - - - - - - - - Próximo: [Adicionando equipes] *O número de caixas de entrada está sujeito a uma política de uso justo com base no número de agentes e no plano assinado. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como conectar Instagram

Use este guia quando você precisar configurar, entender ou validar Como conectar Instagram na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado Para a versão em nuvem da IAra, siga este guia. Pré-requisitos Antes de trazer sua caixa de entrada do Instagram para a IAra, você precisa ter uma conta Business Instagram. Configure uma conta comercial no Instagram, se ainda não tiver uma. Este guia do Instagram ajudará você a fazer o mesmo. Como criar uma caixa de entrada do Instagram na IAra? Etapa 1. Vá para Configurações → Caixas de entrada → “Adicionar caixa de entrada”. Etapa 2. Clique no botão "Continuar com Instagram". Etapa 3. Habilite "Acessar e gerenciar mensagens" e clique no botão permitir para continuar a autorização Etapa 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á ver e responder na IAra. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como conectar Facebook

Use este guia quando você precisar configurar, entender ou validar Como conectar Facebook na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado Para a versão em nuvem da IAra, siga as etapas abaixo. Etapa 1. Vá para Configurações → Caixas de entrada → “Adicionar caixa de entrada”. Etapa 2. Clique no ícone "Mensageiro". Etapa 3. Clique no botão de login do Facebook. Irá abrir uma nova janela para você fazer login. Etapa 4. Autentique-se no Facebook e selecione a página que deseja conectar. Habilite todas as permissões mostradas na lista. Isso ajudará a IAra a realizar todas as ações desejadas sem problemas. Etapa 5. Agora você pode selecionar sua página do Facebook no menu suspenso que aparece na IAra. Etapa 6. "Adicionar 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á vê-la e respondê-la na IAra. Configurações adicionais da caixa de entrada Sua caixa de entrada do Facebook recém-configurada agora deve aparecer na sua lista de caixas de entrada. Para ver isso e fazer configurações adicionais em sua caixa de entrada do Facebook, vá para Configurações → Caixas de entrada → clique no ícone de engrenagem na caixa de entrada associada do Facebook. Você verá a seguinte tela: Guia Configurações Ative a saudação do canal. Depois de ativar essa opção, a IAra enviará uma mensagem de saudação para novas conversas criadas na sua caixa de entrada do Facebook. Ativar CSAT. Depois de ativar isso, sua pesquisa de satisfação do cliente será lançada sempre que um ticket for resolvido. Os resultados do CSAT podem ser visualizados posteriormente na seção Relatórios. Reautorizar. Sempre que você precisar reconectar e reautorizar sua página do Facebook, faça isso neste botão. Guia Colaboradores Clique na guia Colaboradores . Aqui você pode adicionar Agentes à Caixa de Entrada ou excluir Agentes que já foram adicionados à Caixa de Entrada. Você também pode ativar ou desativar a atribuição automática de novas conversas aos agentes adicionados a esta caixa de entrada. Clique em Atualizar para salvar as alterações. Guia Horário comercial Clique na guia Horário comercial . Nesta seção você pode definir o horário de trabalho da sua equipe associada à caixa de entrada do Facebook. Clique na caixa de seleção Ativar disponibilidade comercial para esta caixa de entrada se você tiver um horário comercial bem definido. Assim que a caixa de seleção estiver marcada, a seção abaixo será aberta. Você pode escrever sua mensagem para ser exibida ao cliente fora do horário comercial. Observação: Quando a IAra está habilitado em uma caixa de entrada, a mensagem de indisponibilidade é automaticamente suprimida. A IAra tratará das conversas diretamente, mesmo fora do horário comercial. A mensagem de indisponibilidade só será enviada se a IAra transferir a conversa para um agente humano ou se a IAra 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 adequado. Clique no botão Atualizar configuração de horário comercial. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como conectar chat do site

Use este guia quando você precisar configurar e usar este recurso com clareza operacional. Quando usar este guia Use este guia para resolver ou revisar Como conectar chat do site na IAra com mais segurança, sem depender de tentativa e erro. Antes de começar - Defina qual conta, canal, time, agente, conversa ou assistente será usado no teste. - Separe prints, horários, links de conversa ou exemplos reais quando houver investigação. - Evite alterar produção sem validar antes em um cenário controlado. - Se o fluxo envolver IA, confirme se há base de conhecimento, instruções, limites e transferência para humano. Como se preparar 1. Defina qual conta, canal, time, conversa ou assistente será usado no teste. 2. Faça primeiro uma validação controlada antes de alterar um fluxo em uso. 3. Separe prints, horários, links de conversa e mensagens de erro, se houver. 4. Combine quem fará o ajuste e quem validará o resultado. 5. Registre o que foi testado para facilitar a continuidade se precisar pedir ajuda. Passo a passo operacional 1. Acesse a área correspondente no painel da IAra. 2. Revise se você está na conta, caixa de entrada, time ou assistente correto. Na tela: Depois de criar a caixa de entrada do site, use a tela da caixa para revisar o canal antes de copiar o código do widget. chat do site. 3. Faça a configuração ou ação descrita pelo artigo. Na tela: Se precisar voltar à configuração, acesse a lista de caixas e abra a engrenagem da caixa do site. configurar caixa. 4. Teste usando um cenário realista, mas controlado. 5. Confirme se o resultado aparece para quem precisa operar: agente, gestor, cliente ou suporte. 6. Documente qualquer diferença de tela para ajustar o artigo antes da publicação. Problemas comuns - Tentar resolver direto em produção sem teste controlado. - Usar nomes genéricos que confundem agentes, gestores e relatórios. - Não registrar evidência quando algo falha. - Configurar recurso sem definir quem será responsável por operar depois. - Criar automação ou IA sem regra de transferência para humano. Checklist final - [ ] Objetivo do fluxo entendido. - [ ] Pré-requisitos conferidos. - [ ] Teste controlado realizado. - [ ] Evidências salvas quando necessário. - [ ] Responsável pela manutenção definido.

Configurações do chat do site explicadas

Use este guia quando você precisar configurar, entender ou validar Configurações do chat do site explicadas na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado Este documento o ajudará a configurar totalmente o chat ao vivo do seu site. Ele explica como criar e usar as configurações adicionais para a caixa de entrada de um site desejado. Compatibilidade e requisitos O painel da web e o widget de chat ao vivo funcionam com a maioria dos navegadores modernos. Aqui estão as versões de navegador suportadas: - Mozilla Firefox: v52 em diante *Google Chrome: v57 em diante - Chrome: v57 em diante - Apple Safari: v14.1 em diante *Microsoft Edge: v16 em diante Aqui estão as versões de sistema operacional móvel suportadas para o aplicativo móvel IAra: *Android: v5.0 em diante - iOS: v11.0 em diante Como criar um canal de site na IAra? Etapa 1. Vá para a página Caixas de entrada. Vá para Configurações → Caixas de entrada → botão "Adicionar caixa de entrada". Na tela: Abra a caixa de entrada pela engrenagem na lista de caixas para revisar as configurações do widget. configurações da caixa. Etapa 2. Clique no ícone "Site". Etapa 3. Insira o nome do seu site, URL e outros detalhes conforme descrito abaixo. Os campos disponíveis são explicados abaixo. 1. Nome do site Digite o nome do seu site. Por exemplo, Exemplo Inc. 2. Domínio do site Insira o URL do seu site. Por exemplo, www.seusite.com.br 3. Cor do widget Clique na paleta e selecione uma cor para o widget de chat ao vivo do seu site. 4. Título de boas-vindas Escreva uma mensagem de saudação para seus clientes. Por exemplo, Olá 👋 5. Slogan de boas-vindas Por exemplo, estamos aqui para ajudá-lo com suas dúvidas. Pergunte-nos qualquer coisa ou compartilhe seus comentários. 6. Ativar/desativar saudação do canal Ative para enviar mensagem de saudação quando a pessoa atendida iniciar uma conversa 7. Mensagem de saudação do canal Dê uma saudação para iniciar a conversa. Por exemplo, Olá. Como podemos ajudá-lo? Depois que todos os detalhes forem inseridos, clique no botão “Criar caixa de entrada”. Etapa 4. "Adicionar agentes" à caixa de entrada do seu site. As conversas serão roteadas para os agentes somente se eles estiverem associados à caixa de entrada. Mesmo se você for um administrador, precisará adicionar-se como agente à Caixa de entrada para vê-la na tela. Selecione os Agentes no menu suspenso e clique em Adicionar agentes. Se os agentes não tiverem sido adicionados, siga as etapas para adicionar agentes. Etapa 5. Viva! Você criou com sucesso uma caixa de entrada de site. Agora, adicione o widget ao seu site. Copie e cole o snippet de código mostrado na página em seu site e comece a oferecer suporte aos seus clientes. Você pode clicar no botão Copiar para copiar e depois colar no arquivo raiz do seu site. Se você clicar no botão "Mais configurações", você será direcionado para as configurações adicionais da Caixa de entrada. Se você clicar no botão "Leve-me lá", você será direcionado para a Caixa de entrada recém-criada. Etapa 6. Se você deseja atualizar os agentes com acesso à caixa de entrada, vá em Configurações → Caixas de entrada. Você poderá ver a caixa de entrada do seu site listada lá. Clique em Configurações. Você poderá ver o código e também a lista de agentes que têm acesso à caixa de entrada. Conclua a configuração da caixa de entrada do site Você já tem uma caixa de entrada de site funcional. Vamos dar uma olhada nas configurações adicionais da Caixa de entrada. Na tela Caixas de entrada, clique no ícone de engrenagem para acessar a página Configurações. Você verá a seguinte tela: Na tela: A visão da caixa ajuda a conferir se a configuração conversa com o atendimento real. visão da caixa. Aba Configurações Role para baixo para ver mais configurações, onde você pode definir as várias notificações que gostaria de receber quando a caixa de entrada do seu site começar a funcionar. Aqui estão alguns exemplos para sua compreensão: Ativar caixa de coleta de e-mail está ativado por padrão. Isso significa que uma mensagem automática para coletar o ID do e-mail será exibida assim que a pessoa atendida iniciar uma conversa. A pessoa atendida/pessoa atendida receberá uma solicitação para inserir uma ID de e-mail. Ativar CSAT. Depois de ativar isso, sua pesquisa de satisfação do cliente será lançada sempre que um ticket for resolvido. Os resultados do CSAT podem ser visualizados posteriormente na seção Relatórios. Clique no botão "Atualizar" para salvar as alterações feitas. Guia Colaboradores Clique na guia "Colaboradores". Aqui você pode adicionar Agentes à Caixa de Entrada ou excluir Agentes já adicionados à Caixa de Entrada. Você também pode ativar ou desativar a atribuição automática de novas conversas aos agentes adicionados a esta caixa de entrada. Clique em Atualizar para salvar as alterações. Guia Horário comercial**** Clique na guia "Horário comercial". Nesta seção você pode definir o horário de trabalho da sua equipe. Marque a caixa de seleção Ativar disponibilidade comercial para esta caixa de entrada se você tiver um horário comercial bem definido. Assim que a caixa for marcada, uma nova seção será aberta, como mostrado abaixo. Você pode escrever sua mensagem para ser exibida ao cliente fora do horário comercial. Observação: Quando a IAra está habilitado em uma caixa de entrada, a mensagem de indisponibilidade é automaticamente suprimida. A IAra tratará das conversas diretamente, mesmo fora do horário comercial. A mensagem de indisponibilidade só será enviada se a IAra transferir a conversa para um agente humano ou se a IAra 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 adequado. Clique no botão Atualizar configuração de horário comercial. Guia Formulário pré-chat Clique na guia "Formulário pré-chat". Com isso, você pode  assim que eles entrarem na janela de chat ao vivo/widget do site. Você pode usar isso para coletar nome, endereço de e-mail e muito mais antes de iniciar o bate-papo. Os campos vistos são explicados abaixo: 1. Habilite o formulário pré-chat Selecione Sim ou Não. Sim, se quiser usar o formulário pré-chat. Não, se você quiser mantê-lo desativado. 2. Mensagem pré-chat Escreva uma mensagem para iniciar uma conversa com a pessoa atendida. Por exemplo, Olá, precisamos de algumas informações para melhor atendê-lo. 3. Campos do formulário pré-chat Verifique os necessários. Imp: "Nome", "E-mail" e "Telefone" são os únicos atributos padrão para o formulário pré-chat. Os demais campos são criados por meio de atributos customizados. Se você precisar de campos personalizados em seu formulário, crie-os como atributos personalizados primeiro. Clique no botão "Atualizar". O formulário pré-chat está ativado agora. Guia Configuração Clique na aba “Configuração”. Você pode encontrar o trecho de código a ser copiado para o site aqui. Você pode clicar no botão Copiar para copiar o código e colá-lo no arquivo raiz do seu site. Guia Widget Builder**** Você pode personalizar seu widget da web com configurações simples fornecidas nesta página. Você poderá ver suas alterações ao vivo. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como instalar o chat usando Google Tag Manager

Use este guia quando você precisar configurar, entender ou validar Como instalar o chat usando Google Tag Manager na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado Se estiver usando o Gerenciador de tags do Google em seu site, você pode instalar a IAra a partir do painel do Gerenciador de tags do Google criando uma nova tag para a IAra. Para instalar o widget de chat ao vivo IAra, siga as etapas abaixo. Etapa 1. Acesse o console do Gerenciador de tags**** Faça login no espaço de trabalho do Tag Manager com sua conta do Google. Você verá uma área de trabalho semelhante à mostrada abaixo. Clique no botão "Adicionar uma nova tag" no painel. Etapa 2. Crie uma nova tag com configuração de tag**** Você verá um pop-up para criar uma tag. Mude o nome de “Untitled Tag” para “IAra” ou um nome de sua preferência. Clique na configuração da tag e selecione o tipo de tag "HTML personalizado" na lista. Copie o script da configuração da caixa de entrada na IAra para a área de texto do script HTML, conforme mostrado abaixo. Marque a caixa de seleção "Suporte document.write". Etapa 3. Configure o acionamento**** Clique em “Acionamento” e selecione “Todas as páginas” na lista. Clique em "Salvar" para salvar a tag. Você poderá ver a tag listada em Alterações no espaço de trabalho. Clique em "Enviar" para implantar a tag. Forneça um nome de versão e implante as alterações clicando em “Publicar”. Etapa 4. Marque suas tarefas Você implantou com sucesso o widget de chat ao vivo IAra em seu site. Atualize seu site para ver o widget de chat ao vivo aparecer em todas as páginas. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como instalar o chat em site WordPress

Use este guia quando você precisar configurar, entender ou validar Como instalar o chat em site WordPress na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado WordPress é um sistema de gerenciamento de conteúdo popular. Se você estiver hospedando seu site no WordPress, poderá adicionar um widget de chat ao vivo IAra e conversar com seus visitantes em tempo real. Isso pode ser feito inserindo o código do widget no site ou usando o Google Tag Manager. Etapa 1. Baixe o plugin IAra Se sua conta tiver acesso a um pacote de plugin fornecido pela Digi2B, use esse arquivo. Na maioria dos casos, instale o chat pelo código do widget ou pelo Google Tag Manager. Etapa 2. Faça upload do plugin para o seu site WordPress Faça login na sua conta do WordPress. Navegue até o Painel de Administração e clique em “Plugins” na barra lateral. Você poderá ver o botão "Adicionar novo". Você verá uma opção para fazer upload do plugin, conforme mostrado na imagem abaixo. Clique em “Upload” e selecione o arquivo Zip baixado na etapa 1. Etapa 3. Ative o plugin Assim que o plugin for carregado, você verá uma tela de sucesso com a opção “Ativar plugin”, conforme mostrado abaixo. Clique no botão “Ativar Plug-in”. Parabéns! O plug-in agora está instalado. Para concluir a configuração, você deve compartilhar as credenciais do aplicativo IAra, conforme mostrado nas etapas abaixo. Etapa 4. Configure o plugin Agora, você poderá ver “Configurações da IAra” no menu “Configurações”. Clique nele para atualizar a configuração do chat ao vivo. Você verá a tela Configurações conforme mostrado abaixo. Configure seu plugin IAra aqui para que funcione. Antes de instalar no WordPress, crie uma caixa de entrada do tipo Site. Consulte Como conectar chat do site. Os campos do formulário são explicados abaixo. 1. Token do site da IAra/URL de instalação da IAra Depois de criar uma caixa de entrada de canal de site na instalação da IAra, você receberá um script. Você pode copiar o token e o URL conforme mostrado abaixo. 2. Design de widget IAra oferece suporte a dois designs de widget de chat ao vivo – design padrão e design de bolha expandida. Escolha sua preferência. 3. Posição do widget Você pode selecionar onde colocar o widget de chat ao vivo no site com base em sua preferência. As opções disponíveis são Esquerda e Direita. 4. Idioma IAra suporta mais de 30 idiomas. O idioma padrão é o inglês. 5. Texto do iniciador Este é um campo opcional. Se você usar o design de bolha expandida, poderá usar o texto do iniciador para personalizar o texto exibido na bolha. Depois de preencher o formulário, clique no botão "Salvar alterações". Além disso, certifique-se de ter configurado a caixa de entrada do site da IAra. Etapa 5. Verifique se o plugin está funcionando corretamente Visite seu site e veja se o widget aparece no site! Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como instalar o chat em site Webflow

Use este guia quando você precisar configurar, entender ou validar Como instalar o chat em site Webflow na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado Se o seu site foi criado com Webflow e você deseja conversar com os visitantes do site Webflow em tempo real, você pode adicionar o widget de chat ao vivo IAra ao seu site. Siga as etapas descritas abaixo. Etapa 1. Crie uma caixa de entrada de site na IAra Consulte este guia para obter instruções detalhadas sobre como configurar uma caixa de entrada de site na IAra. Etapa 2. Instale o script gerado no Webflow Faça login em sua conta Webflow e selecione seu site. Selecione Configurações. Vá para Código personalizado -> Código de rodapé. Cole o script no "Código do Rodapé". Salve as alterações. Etapa 3. Publique as alterações Clique em Publicar -> Selecione o site -> Publicar nos domínios selecionados. Etapa 4. Verifique Visite seu site e veja se o widget aparece no site. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como instalar o chat em site Docusaurus

Use este guia para instalar o chat da IAra em um site feito com Docusaurus. Antes de começar - Tenha uma caixa de entrada do tipo Site criada na IAra. - Copie o websiteToken da caixa de entrada. - Confirme a URL base da sua instalação, por exemplo https://app.digi2b.com. - Tenha acesso ao repositório do site Docusaurus. Opção recomendada: componente de cliente No Docusaurus, uma forma segura de carregar o widget é criar um componente que injeta o SDK no navegador. Crie o arquivo src/theme/Root.js: import React, { useEffect } from 'react'; export default function Root({ children }) { useEffect(() => { window.chatwootSettings = { hideMessageBubble: false, position: 'right', locale: 'pt_BR', type: 'standard', darkMode: 'auto', }; const baseUrl = 'https://app.digi2b.com'; const script = document.createElement('script'); script.src = baseUrl + '/packs/js/sdk.js'; script.async = true; script.onload = () => { window.chatwootSDK.run({ websiteToken: 'SEU_WEBSITE_TOKEN', baseUrl, }); }; document.body.appendChild(script); return () => { document.body.removeChild(script); }; }, []); return <>{children}</>; } Observação técnica Os objetos window.chatwootSettings e window.chatwootSDK podem manter esse nome por compatibilidade com o SDK herdado. Use os nomes exatamente como aparecem no snippet. Como testar 1. Rode o Docusaurus localmente. 2. Abra uma página pública do site. 3. Confirme se o balão do chat aparece. 4. Envie uma mensagem de teste. 5. Verifique se a conversa chegou na caixa de entrada correta da IAra. Problemas comuns - Usar baseUrl diferente do domínio real. - Copiar token de outra caixa. - Bloqueio por CSP, cache ou ad blocker. - Inserir o script em arquivo que não roda no navegador.

Como instalar o chat em site Gatsby

Use este guia quando você precisar configurar, entender ou validar Como instalar o chat em site Gatsby na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado Observação técnica: por compatibilidade com o SDK herdado, alguns objetos de código podem continuar usando nomes como window.chatwootSettings e window.chatwootSDK. Use esses nomes exatamente como aparecem no snippet. Se você tem um site criado em Gatsby, pode adicionar um widget de chat ao vivo IAra e conversar com seus visitantes em tempo real. Isso pode ser feito em 3 etapas simples usando o plugin Gatsby da IAra. Etapa 1. Adicione o plugin Gatsby ao seu projeto Adicione gatsby-plugin-iara ao seu projeto Gatsby. npm install --save gatsby-plugin-iara Se você estiver usando Yarn, use o seguinte: yarn add gatsby-plugin-iara Etapa 2. Adicione o plug-in ao arquivo de configuração do Gatsby**** // No seu gatsby-config.js plug-ins: [ { resolver: `gatsby-plugin-iara`, opções: { baseUrl: "BASE_URL", // Obrigatório websiteToken: "WEBSITE_TOKEN", // Obrigatório includeInDevelopment: false, // Opcional chatwootSettings: {}, // Opcional }, }, ]; Você pode obter o token do site e o URL base nas configurações da caixa de entrada da sua conta da IAra. Se você precisar criar um novo canal de site, siga o procedimento ilustrado aqui. Etapa 3. Inicie seu servidor Você poderá ver o widget IAra na página agora. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como instalar o chat em app Next.js

Use este guia para instalar o widget de chat da IAra em uma aplicação Next.js. Antes de começar - Crie uma caixa de entrada do tipo Site na IAra. - Copie o websiteToken. - Confirme a URL base da instalação. - Defina se seu projeto usa App Router ou Pages Router. App Router Crie um componente de cliente, por exemplo components/IaraWidget.jsx: 'use client'; import { useEffect } from 'react'; export default function IaraWidget() { useEffect(() => { window.chatwootSettings = { hideMessageBubble: false, position: 'right', locale: 'pt_BR', type: 'standard', darkMode: 'auto', }; const baseUrl = 'https://app.digi2b.com'; const script = document.createElement('script'); script.src = baseUrl + '/packs/js/sdk.js'; script.async = true; script.onload = () => { window.chatwootSDK.run({ websiteToken: 'SEU_WEBSITE_TOKEN', baseUrl, }); }; document.body.appendChild(script); return () => { document.body.removeChild(script); }; }, []); return null; } Depois, importe em app/layout.jsx: import IaraWidget from '@/components/IaraWidget'; export default function RootLayout({ children }) { return ( <html lang="pt-BR"> <body> {children} <IaraWidget /> </body> </html> ); } Pages Router Se o projeto usa pages/, importe o componente em pages/_app.jsx: import IaraWidget from '../components/IaraWidget'; export default function App({ Component, pageProps }) { return ( <> <Component {...pageProps} /> <IaraWidget /> </> ); } Observação técnica Os objetos window.chatwootSettings e window.chatwootSDK podem manter esse nome por compatibilidade com o SDK herdado. Não renomeie esses objetos no código. Como testar 1. Rode o projeto localmente. 2. Abra uma página pública. 3. Envie uma mensagem pelo widget. 4. Confira se a conversa entrou na caixa certa da IAra.

Como instalar o chat em app Vue.js

Use este guia para instalar o widget de chat da IAra em uma aplicação Vue.js. Antes de começar - Crie uma caixa de entrada do tipo Site na IAra. - Copie o script do widget ou o websiteToken. - Confirme se você tem acesso ao arquivo index.html do projeto. Passo a passo 1. Abra o arquivo public/index.html ou index.html, conforme a estrutura do projeto. 2. Cole o script antes do fechamento de </body>. 3. Troque SEU_WEBSITE_TOKEN pelo token real da caixa. 4. Troque baseUrl pelo domínio correto da instalação. <body> <noscript> <strong>Este aplicativo precisa de JavaScript habilitado para funcionar.</strong> </noscript> <div id="app"></div> <script> (function (d, t) { var BASE_URL = 'https://app.digi2b.com'; var g = d.createElement(t); var s = d.getElementsByTagName(t)[0]; g.src = BASE_URL + '/packs/js/sdk.js'; g.defer = true; g.async = true; s.parentNode.insertBefore(g, s); g.onload = function () { window.chatwootSDK.run({ websiteToken: 'SEU_WEBSITE_TOKEN', baseUrl: BASE_URL, }); }; })(document, 'script'); </script> </body> Como testar Abra o site em ambiente local ou homologação. O balão deve aparecer depois que o JavaScript carregar. Envie uma mensagem e confira se ela entra na caixa correta. Observação técnica O SDK pode usar window.chatwootSDK por compatibilidade. Mantenha esse nome no código.

Como instalar o chat em app React Native

Use este guia para instalar o widget de chat da IAra em um app React Native. Antes de começar - Crie uma caixa de entrada do tipo Site na IAra. - Copie websiteToken e baseUrl. - Confirme com a Digi2B qual pacote do widget móvel está habilitado para sua instalação. - Instale as dependências nativas exigidas pelo pacote. Instalação Use o pacote indicado para sua conta. Em contas IAra, o pacote pode ser disponibilizado como: yarn add @iara/react-native-widget ou: npm install @iara/react-native-widget --save Em iOS, rode: cd ios && pod install Exemplo de uso import React, { useState } from 'react'; import { SafeAreaView, StyleSheet, Text, TouchableOpacity, View } from 'react-native'; import IaraWidget from '@iara/react-native-widget'; export default function App() { const [showWidget, setShowWidget] = useState(false); const user = { identifier: 'cliente-123', name: 'Maria Souza', avatar_url: '', email: '[email protected]', identifier_hash: '', }; const customAttributes = { accountId: 1, plan: 'paid', status: 'active', }; return ( <SafeAreaView style={styles.container}> <View> <TouchableOpacity style={styles.button} onPress={() => setShowWidget(true)}> <Text style={styles.buttonText}>Abrir atendimento</Text> </TouchableOpacity> </View> {showWidget && ( <IaraWidget websiteToken="SEU_WEBSITE_TOKEN" locale="pt_BR" baseUrl="https://app.digi2b.com" closeModal={() => setShowWidget(false)} isModalVisible={showWidget} user={user} customAttributes={customAttributes} /> )} </SafeAreaView> ); } const styles = StyleSheet.create({ container: { flex: 1, justifyContent: 'center', alignItems: 'center', }, button: { height: 48, paddingHorizontal: 16, backgroundColor: '#1F93FF', borderRadius: 8, justifyContent: 'center', }, buttonText: { color: '#fff', fontWeight: '600', fontSize: 16, }, }); Como testar 1. Abra o app em simulador ou dispositivo real. 2. Toque em Abrir atendimento. 3. Envie uma mensagem pelo widget. 4. Confirme se a conversa aparece na caixa de entrada da IAra.

Como enviar dados adicionais pelo SDK do widget

Use este guia quando você precisa enviar dados adicionais do usuário pelo SDK do widget da IAra. Observação técnica importante Por compatibilidade com a base herdada, o SDK pode expor objetos com nomes como window.$chatwoot, window.chatwootSettings e window.chatwootSDK. Use esses nomes exatamente como aparecem no código, a menos que a Digi2B informe um alias específico para sua instalação. Detectar quando o SDK carregou window.addEventListener('chatwoot:ready', function () { // Use window.$chatwoot aqui }); Para ouvir mensagens recebidas no widget: window.addEventListener('chatwoot:on-message', function (event) { console.log('chatwoot:on-message', event.detail); }); Configurações do widget window.chatwootSettings = { hideMessageBubble: false, showUnreadMessagesDialog: false, position: 'left', locale: 'pt_BR', useBrowserLanguage: false, type: 'standard', darkMode: 'auto', // baseDomain: 'seudominio.com' }; Abrir, fechar e alternar o widget window.$chatwoot.toggle(); window.$chatwoot.toggle('open'); window.$chatwoot.toggle('close'); Para mostrar ou ocultar o balão: window.$chatwoot.toggleBubbleVisibility('show'); window.$chatwoot.toggleBubbleVisibility('hide'); Identificar usuário window.$chatwoot.setUser('cliente-123', { email: '[email protected]', name: 'Maria Souza', avatar_url: 'https://seudominio.com/avatar/maria.png', phone_number: '+5511999999999', }); Se sua conta usa validação de identidade, envie também identifier_hash: window.$chatwoot.setUser('cliente-123', { name: 'Maria Souza', email: '[email protected]', identifier_hash: 'HASH_GERADO_NO_BACKEND', }); Atributos personalizados window.$chatwoot.setCustomAttributes({ accountId: 123, pricingPlan: 'premium', lastPurchaseDate: '2026-06-01', }); Para remover um atributo: window.$chatwoot.deleteCustomAttribute('pricingPlan'); Etiquetas na conversa window.$chatwoot.setLabel('lead-qualificado'); window.$chatwoot.removeLabel('lead-qualificado'); Redefinir sessão no logout Quando o usuário sair do seu sistema, limpe a sessão do widget para evitar histórico indevido: window.$chatwoot.reset();

Como continuar conversas do chat por e-mail

Use este guia quando você precisar configurar, entender ou validar Como continuar conversas do chat por e-mail na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado Seus clientes podem continuar suas conversas de bate-papo com seus agentes por meio de conversas por e-mail. Isso pode ser necessário nas seguintes circunstâncias. *Não há agentes disponíveis e a pessoa atendida deixa uma mensagem no chat. - A pessoa atendida sai do chat antes que o agente responda. Para que isso funcione, o contato deve possuir um endereço de e-mail na IAra CRM. Obtenção de endereços de e-mail de contatos Você pode solicitar/atualizar e-mails de clientes na IAra das seguintes maneiras. 1. Da IAra SDK**** Se o e-mail do cliente for conhecido, você poderá fornecê-lo ao iara por meio do método setUser em nosso . 2. Do formulário pré-chat**** 3. Do prompt de coleta por e-mail**** Quando o formulário pré-chat está desativado e o e-mail do cliente é desconhecido, a IAra inicia uma conversa com um prompt de coleta de e-mail. Observação: Quando a IAra está ativado em uma caixa de entrada, o prompt de coleta de e-mail é automaticamente suprimido. A IAra tratará das conversas diretamente, mesmo fora do horário comercial. A solicitação de coleta de e-mail só será enviada se a IAra transferir a conversa para um agente humano ou se a IAra não estiver configurado para a caixa de entrada. Continuidade da conversa Se o endereço de e-mail do cliente for atualizado por meio de alguma das opções mencionadas acima e ele sair do chat enquanto o agente responde, acontece o seguinte. - A pessoa atendida recebe um tópico por e-mail com um resumo da conversa. Eles podem responder a esse e-mail e continuar a conversa. - O agente recebe as respostas do cliente por e-mail em seu painel da IAra, continuadas na conversa existente. O ícone de e-mail no balão de bate-papo indica que a pessoa atendida respondeu por e-mail. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como ativar validação de identidade no widget

Use este guia para ativar validação de identidade no widget da IAra usando HMAC. Para que serve A validação de identidade reduz risco de personificação. Ela garante que o usuário identificado no widget foi assinado pelo seu backend antes de ser aceito pela IAra. Antes de começar - Acesse a caixa de entrada do tipo Site. - Copie o token de HMAC em Configurações da caixa > Configuração > Validação de identidade. - Gere o hash sempre no backend. Nunca exponha o segredo HMAC no navegador. Como funciona Você gera um hash SHA256 usando o segredo HMAC da caixa e o identificador único do usuário, por exemplo cliente-123. Exemplos de geração de HMAC Node.js const crypto = require('crypto'); const key = '<webwidget-hmac-token>'; const identifier = '<identifier>'; const identifierHash = crypto .createHmac('sha256', key) .update(identifier) .digest('hex'); Python import hashlib import hmac secret = bytes('<webwidget-hmac-token>', 'utf-8') identifier = bytes('<identifier>', 'utf-8') identifier_hash = hmac.new(secret, identifier, hashlib.sha256).hexdigest() Ruby require 'openssl' key = '<webwidget-hmac-token>' identifier = '<identifier>' identifier_hash = OpenSSL::HMAC.hexdigest('sha256', key, identifier) PHP <?php $key = '<webwidget-hmac-token>'; $identifier = '<identifier>'; $identifier_hash = hash_hmac('sha256', $identifier, $key); ?> Enviar hash para o widget window.$chatwoot.setUser('cliente-123', { name: 'Maria Souza', email: '[email protected]', identifier_hash: 'HASH_GERADO_NO_BACKEND', }); Cuidados de segurança - Não gere o HMAC no frontend. - Não publique o token HMAC no código do site. - Use um identificador estável para o usuário. - Regere o hash quando o usuário muda de sessão ou identidade.

Como ativar modo escuro no widget do site

Use este guia quando você precisar configurar, entender ou validar Como ativar modo escuro no widget do site na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado Observação técnica: por compatibilidade com o SDK herdado, alguns objetos de código podem continuar usando nomes como window.chatwootSettings e window.chatwootSDK. Use esses nomes exatamente como aparecem no snippet. Os sites modernos permitem que os usuários alternem entre os modos claro e escuro. Por isso, é importante um chat ao vivo que funcione com os dois temas. Este guia ajuda você a configurar o modo escuro para o widget de chat ao vivo IAra em seu site. Aqui está uma rápida visão de como o modo escuro funciona no widget de chat ao vivo: Para ativar o modo escuro no widget IAra, use o parâmetro darkMode junto com chatwootSettings. O parâmetro darkMode aceita dois valores. 1. light - Ative apenas o modo light. Este é o valor padrão. 2. auto - Ative o modo escuro com base na preferência do sistema operacional. window.chatwootSettings = { //... outras configurações darkMode: "automático", }; Observação: dark não é compatível agora. Adicionaremos o suporte em versões futuras. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como conectar e-mail na IAra

Use este guia quando você precisar configurar, entender ou validar Como conectar e-mail na IAra na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado Para gerenciar seu e-mail de suporte ao cliente/tickets da IAra, você pode criar uma caixa de entrada de e-mail na IAra. Este é um guia completo para colocar seu canal de e-mail em funcionamento. 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 email da Microsoft Sinta-se à vontade para pular para qualquer seção. Vamos rolar. Como criar uma caixa de entrada de e-mail na IAra? Etapa 1. Abra o painel da IAra. Vá para Configurações → Caixas de entrada → Adicionar Caixa de entrada. Etapa 2. Clique no ícone "E-mail". Etapa 3. Insira o nome do canal (como você gostaria de abordar este canal) e 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 a Microsoft como provedor de e-mail. Se você usa um e-mail do Outlook/Microsoft, vá até a seção "Como criar um canal de e-mail da Microsoft?" (última seção). Etapa 4. "Adicionar agentes" à sua caixa de entrada de e-mail. Você criou com sucesso uma caixa de entrada de e-mail. Etapa 5. Defina suas configurações de e-mail. Vá para Configurações → Caixas de entrada → Configurações da caixa de entrada de e-mail → guia 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 configurações são explicadas nas seções a seguir. Como encaminhar e-mails para a caixa de entrada da IAra? Etapa 1. Copie o "Encaminhar para endereço de e-mail" da guia Configuração em Configurações da caixa de entrada. Etapa 2. Configure o endereço de e-mail copiado como endereço de encaminhamento de e-mail na caixa de entrada de e-mail. P.S. Verifique a seção Gmail abaixo para saber como adicionar um endereço de encaminhamento no Gmail. Etapa 3. Envie um e-mail para a caixa de entrada do endereço de encaminhamento adicionado e verifique a caixa de entrada de e-mail da IAra para obter o novo e-mail. Como configurar o IMAP para o canal Email? Se você estiver usando o Gmail, role para baixo até a seção IMAP do Gmail abaixo. Etapa 1. Vá para Configurações → Caixas de entrada → Configurações da caixa de entrada de e-mail → guia Configuração. Etapa 2. Marque a caixa de seleção Ativar configuração IMAP para esta caixa de entrada. Você poderá ver os campos obrigatórios da seguinte maneira. 1. Endereço 2. Porto 3. E-mail 4. Senha P.S. Se estiver usando um Gmail habilitado para 2FA, role para baixo até "Como gerar senha de aplicativo para Gmail?" seção. Se estiver usando uma conta normal do Gmail, role para baixo até “Como permitir acesso menos seguro ao Gmail?” seção. Etapa 3. Teste se tudo está funcionando bem. Envie um e-mail para o e-mail configurado pelo IMAP na IAra. Verifique a caixa de entrada da IAra para obter o novo e-mail. Abra a conversa por email na IAra e verifique os detalhes do email. Como configurar o SMTP para o canal Email? Etapa 1. Vá para Configurações -> Caixas de entrada -> página de configurações da caixa de entrada de e-mail. Etapa 2. Selecione a guia "Configuração". Etapa 3. Para ativar o SMTP, marque a caixa de seleção "Ativar configuração SMTP para esta caixa de entrada". Preencha os campos abaixo e clique no botão "Atualizar configurações de SMTP". 1. Endereço 2. Porto 3. E-mail 4. Senha P.S. Se estiver usando um Gmail habilitado para 2FA, role para baixo até "Como gerar senha de aplicativo para Gmail?" seção. Se estiver usando uma conta normal do Gmail, role para baixo até “Como permitir acesso menos seguro ao Gmail?” seção. 5. Domínio Etapa 4. Abra uma conversa de e-mail existente na IAra. Etapa 5. Digite uma mensagem de resposta para a conversa e clique no botão “Enviar”. Verifique se a correspondência foi entregue. Você também pode verificar a caixa de entrada do destinatário do e-mail entregue. Configurações para usuários do Gmail Como ativar o IMAP para a caixa de entrada do Gmail? Etapa 1. Abra sua caixa de entrada do Gmail e clique no ícone Configurações no canto superior direito. Clique no botão "Ver todas as configurações". Etapa 2. Selecione a guia "Encaminhamento e POP/IMAP" na página Configurações. Etapa 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? Observação: esta opção não está disponível para contas do Gmail com verificação em duas etapas ativada ou gerenciadas por uma organização. Etapa 1. Acesse Segurança da Conta do Google. Etapa 2. Clique em “Ativar acesso” na seção “Acesso a aplicativos menos seguros” na página Segurança. Etapa 3. Alterne "Permitir aplicativos menos seguros" para "ATIVADO". Agora você pode usar a senha da sua conta do Gmail para configurar IMAP/SMTP. Como gerar senha de aplicativo para Gmail? Observação: esta opção é válida para contas do Gmail com verificação em duas etapas ativada ou gerenciadas por uma organização. Etapa 1. Acesse Segurança da Conta do Google. Etapa 2. Clique em “Senhas de aplicativos” na seção “Fazer login no Google” na página Segurança. Etapa 3. Selecione o aplicativo Mail, selecione um dispositivo e clique em "GERAR". Use a senha gerada para configurar IMAP/SMTP. Como adicionar um endereço de encaminhamento para o Gmail? Etapa 1. Abra sua caixa de entrada do Gmail e clique no ícone Configurações no canto superior direito. Clique no botão "Ver todas as configurações". Etapa 3. Clique no botão "Adicionar um endereço de encaminhamento". Ele solicitará o endereço de e-mail de encaminhamento. Digite aquele da IAra e clique no botão "Avançar". Etapa 4. Confirme o endereço de encaminhamento no pop-up do navegador. A caixa de entrada do e-mail enviará um código de verificação para o endereço de e-mail de encaminhamento. Etapa 5. Copie o código de verificação da caixa de entrada de e-mail da IAra. Etapa 6. Cole o código de verificação e clique no botão "Verificar". Etapa 7. Selecione a opção “Encaminhar uma cópia do e-mail recebido”. Escolha a ação necessária no segundo menu suspenso e clique no botão "Salvar alterações". Como criar um canal de email da Microsoft? Etapa 1. Abra o painel da IAra. Vá para Configurações → Caixas de entrada → Adicionar Caixa de entrada. Etapa 2. Clique no ícone "E-mail". Etapa 3. Clique no ícone “Microsoft”. Etapa 4. Adicione seu e-mail do Outlook/Microsoft. Etapa 5. Insira suas credenciais do Microsoft/Outlook. Etapa 6. Permita que o aplicativo "IAra" leia e responda seu e-mail. Etapa 7. "Adicionar agentes" à sua caixa de entrada de e-mail. Você criou com sucesso uma caixa de entrada de e-mail da Microsoft. Etapa 5. Defina suas configurações de e-mail. Vá para Configurações → Caixas de entrada → Configurações da caixa de entrada de e-mail → guia Configuração. Nota: Por enquanto, não altere nada em Configurações, pois usamos os valores padrão para IMAP e SMTP. Em breve tornaremos esses campos não editáveis para contas do Outlook. Usamos configurações IMAP padrão para buscar e-mails e SMTP para enviar; você não precisa definir nada por meio da configuração. Etapa 6. Se o seu token de acesso expirar, você deverá autorizar novamente sua conta da Microsoft acessando Configurações -> Configuração. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como conectar Telegram

Use este guia quando você precisar configurar, entender ou validar Como conectar Telegram na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado Etapa 1. Vá para Configurações → Caixas de entrada → “Adicionar caixa de entrada”. Etapa 2. Clique no ícone "Telegrama". Etapa 3. Crie um novo bot do Telegram usando o Telegram BotFather. Etapa 4. Insira o token API do bot do Telegram e clique em “Criar canal do Telegram”. Etapa 5. "Adicionar agentes" à sua caixa de entrada do Telegram. A configuração da caixa de entrada está concluída. Etapa 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 BotFather. Etapa 7. Envie uma mensagem para o bot do Telegram. Verifique a caixa de entrada da IAra Telegram para a nova mensagem. Perguntas frequentes A IAra oferece suporte a contas Telegram Business Bot? Sim – o suporte para bots do modo Telegram Business foi adicionado na IAra v4.3.0 (18 de junho de 2025). Como habilitar Business Bots? 1. Em @BotFather execute /business_mode, escolha seu bot e confirme. 2. Crie uma nova caixa de entrada do Telegram na IAra (Configurações → Caixas de entrada → Adicionar caixa de entrada → Telegram) e cole o mesmo token do bot. 3. A IAra detecta automaticamente o Modo Empresarial e registra o webhook correto. 4. Para obter melhores resultados, mantenha este bot Business em sua própria caixa de entrada, separado de qualquer bot padrão que você já usa.  Problemas conhecidos com o Business Bot • Janela de resposta de 24 horas – o Telegram só permite que o bot (e a IAra) responda dentro de 24 horas após a última mensagem do cliente.  • Se um usuário já conversou anteriormente com o mesmo bot fora do Modo Empresarial, as respostas podem parecer vir do bot e não da conta Empresarial; criar um bot de negócios e uma caixa de entrada dedicados evita essa confusão. • A API Telegram Business atualmente é menos rica em recursos do que a API Bot normal (por exemplo, sem indicadores de digitação, tipos de mensagens limitados). Mantenha as expectativas de acordo. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como conectar Line

Use este guia quando você precisar configurar, entender ou validar Como conectar Line na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado Etapa 1. Vá para Configurações → Caixas de entrada → “Adicionar caixa de entrada”. Etapa 2. Clique no ícone "Linha". Etapa 3. Acesse o Line Developer Console e crie uma conta do Line. Etapa 4. Crie um "Provedor" no console do desenvolvedor. Crie um novo canal "API de mensagens" (Bot) no provedor. Etapa 5. Preencha os campos abaixo no console do desenvolvedor Line (canal API de mensagens) e clique em "Criar canal LINE". 1. Nome do canal 2. ID do canal LINE 3. Segredo do canal LINE 4. Token do canal LINE Etapa 6. "Adicionar agentes" à sua caixa de entrada do Line. A configuração da caixa de entrada está concluída. Etapa 7. Vá para o canal "API de mensagens" no console do desenvolvedor e configure o webhook. 1. Verifique o URL do webhook da IAra 2. Ative "Usar webhook" Etapa 8. Teste sua nova caixa de entrada do Line. Envie uma mensagem para o bot Line. Verifique a caixa de entrada da IAra Line para obter a nova mensagem. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como criar uma caixa de entrada de API

Use este guia para criar uma caixa de entrada de API na IAra e integrar conversas vindas de um sistema próprio. Quando usar Use caixa de entrada de API quando você quer conectar um canal que não existe nativamente na IAra, como um app próprio, portal do cliente, plataforma vertical ou experiência de chat dentro do seu produto. Criar a caixa de entrada 1. Acesse Configurações > Caixas de entrada. 2. Clique em Adicionar caixa de entrada. 3. Escolha o canal API. 4. Informe nome do canal e URL de callback. 5. Adicione agentes ou times que vão atender as conversas. 6. Salve e copie os identificadores exibidos na configuração. Fluxo para enviar mensagem O fluxo técnico costuma ter três etapas: 1. Criar ou localizar contato. 2. Criar conversa usando o source_id do contato naquela caixa. 3. Criar mensagem na conversa. As APIs exigem api_access_token no cabeçalho da requisição. Exemplo de contato criado { "email": "[email protected]", "name": "Maria Souza", "phone_number": "+5511999999999", "additional_attributes": {}, "contact_inboxes": [ { "source_id": "source-id-do-contato", "inbox": { "id": 123, "name": "Canal API", "channel_type": "Channel::Api" } } ], "id": 456, "availability_status": "offline" } Use o source_id para iniciar a conversa. Exemplo de mensagem criada { "id": 789, "content": "Mensagem recebida pelo canal API", "inbox_id": 123, "conversation_id": 456, "message_type": 0, "content_type": "text", "content_attributes": {}, "private": false, "sender": { "id": 456, "name": "Maria Souza", "type": "contact" } } Receber mensagens via callback Quando uma nova mensagem for criada no canal API, a IAra envia um POST para a URL de callback configurada. { "event": "message_created", "id": 789, "content": "Mensagem recebida pelo canal API", "message_type": "incoming", "content_type": "text", "content_attributes": {}, "sender": { "id": 456, "name": "Maria Souza", "type": "contact" }, "inbox": { "id": 123, "name": "Canal API" }, "conversation": { "id": 456, "inbox_id": 123, "status": "open" }, "account": { "id": 59, "name": "Minha conta" } } Boas práticas - Salve source_id no seu sistema. - Use identificadores estáveis para contatos. - Valide assinatura de webhook quando disponível. - Registre logs de envio e recebimento. - Evite criar contato duplicado para o mesmo cliente.

Como conectar SMS

Use este guia quando você precisar configurar, entender ou validar Como conectar SMS na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado Você pode configurar a caixa de entrada do seu canal de SMS por meio de dois provedores: 1. Twilio 2. Largura de banda Criando uma caixa de entrada de SMS Siga as etapas abaixo. Etapa 1. Abra seu painel da IAra. Vá para Configurações → Caixas de entrada → Adicionar Caixa de entrada. Etapa 2. Clique no ícone "SMS". Etapa 3. Escolha seu provedor de API e configure a caixa de entrada. Abaixo são explicadas ambas as opções. Escolhendo "Twilio" como provedor de API Se você quiser usar o Twilio para configurar sua caixa de entrada de SMS, escolha-o no menu suspenso. Ele exibirá os campos obrigatórios conforme explicado abaixo. Estas são as entradas necessárias para criar este canal: Clique em Criar canal Twilio depois de preencher as informações. Configurando a IAra com o Twilio Studio**** Se você usar o Twilio Studio para um fluxo de conversa personalizado, atualizar diretamente o URL do webhook interromperá sua integração existente. Nesses casos, você pode [navegar até a seção "Twilio Studio" neste documento]. Escolhendo "Bandwidth" como provedor de API Se você quiser usar largura de banda para configurar sua caixa de entrada de SMS, escolha-a no menu suspenso. Ele exibirá os campos obrigatórios conforme mostrado abaixo. Clique em Criar canal de largura de banda após preencher as informações. Depois de concluir esta etapa, prossiga com a adição de agentes. Etapa 4. "Adicionar agentes" à sua caixa de entrada. Você criou com sucesso uma caixa de entrada de SMS. Você começará a receber as mensagens em seu painel da IAra. Além disso, consulte: Enviar uma campanha de SMS para um grupo de contatos. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como conectar TikTok

Use este guia quando você precisar configurar, entender ou validar Como conectar TikTok na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado Para a versão em nuvem da IAra, siga este guia. Pré-requisitos Antes de configurar o canal TikTok, certifique-se do seguinte: 1. Você tem uma Conta Comercial TikTok registrada em uma região qualificada. 2. Sua conta comercial TikTok está configurada para aceitar mensagens diretas de todos. Caso contrário, você precisará aceitar mensagens manualmente no aplicativo TikTok. Saiba como atualizar suas configurações de mensagens Configurando o canal TikTok Etapa 1: navegar até as caixas de entrada Vá para Configurações > Caixas de entrada e clique em Adicionar caixa de entrada. Selecione TikTok na lista de canais disponíveis. Etapa 2: Conecte sua conta TikTok Clique em Continuar com o TikTok para iniciar o processo de autenticação. Etapa 4: Autorizar IAra Você será redirecionado para o TikTok. Revise as permissões solicitadas e clique em Continuar para autorizar a IAra a acessar sua conta comercial TikTok. \ Etapa 5: Adicionar agentes Após a autorização, você será redirecionado de volta a IAra. Adicione agentes à caixa de entrada do TikTok para que possam ver e responder às mensagens. Seu canal TikTok agora está conectado. As mensagens diretas recebidas do TikTok aparecerão no painel da IAra. Limitações de mensagens - Os clientes devem iniciar a conversa, as empresas não podem enviar mensagens primeiro. - Os agentes podem enviar até 10 mensagens antes que a pessoa atendida responda. Depois que a pessoa atendida responde, as mensagens são ilimitadas. - O período de resposta é de 48 horas a partir da última mensagem do cliente. - Atualmente, apenas mensagens de texto, imagem e post share são suportadas devido a limitações na API TikTok Business Messaging. - As mensagens enviadas diretamente do aplicativo TikTok serão sincronizadas com a IAra. - Mensagens recebidas em formatos não suportados (por exemplo, áudio, adesivos) 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 às 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 ser sinalizada pelo TikTok. Quais países oferecem suporte ao TikTok Business Messaging? A API TikTok Business Messaging não está atualmente disponível no EEE, na Suíça ou no Reino Unido. Os recursos de mensagens podem estar limitados ou indisponíveis para usuários nessas regiões. Para as regiões e restrições suportadas mais recentes, consulte a [documentação] oficial do TikTok (https://business-api.tiktok.com/portal/docs/business-messaging-api/v1.3). Disponibilidade Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como conectar X/Twitter

Use este guia quando você precisar configurar, entender ou validar Como conectar X/Twitter na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado NOTA: A integração do Twitter foi temporariamente descontinuada como resultado de modificações feitas pelo Twitter em suas APIs. Isso inclui limitações no número de solicitações levantadas por minuto, além de alterações substanciais de preços. Com uma caixa de entrada do Twitter, você pode gerenciar os tweets que mencionam você e seus DMs do Twitter na IAra. Para a versão em nuvem da IAra, siga as etapas abaixo. Etapa 1. Vá para Configurações → Caixas de entrada → “Adicionar caixa de entrada”. Etapa 2. Clique no ícone “Twitter”. Etapa 3. Clique no botão "Entrar com Twitter". Etapa 4. Você será redirecionado para o Twitter. Clique no botão "Autorizar aplicativo". Etapa 5. "Adicionar 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 mencionando você na IAra. Configurações adicionais da caixa de entrada Sua caixa de entrada do Twitter recém-configurada agora deve aparecer na sua lista de caixas de entrada. Para ver isso e fazer configurações adicionais em sua caixa de entrada do Twitter, vá para Configurações → Caixas de entrada → clique no ícone de engrenagem na caixa de entrada associada do Twitter. Você verá a seguinte tela: Você pode fazer algumas mudanças fundamentais aqui. Guia Configurações Ative a saudação do canal. Depois de ativar essa opção, a IAra enviará uma mensagem de saudação para novas conversas criadas na sua caixa de entrada do Twitter. Ativar CSAT. Depois de ativar isso, sua pesquisa de satisfação do cliente será lançada sempre que um ticket for resolvido. Os resultados do CSAT podem ser visualizados posteriormente na seção Relatórios. Guia Colaboradores Clique na guia Colaboradores . Aqui, você pode adicionar Agentes à Caixa de Entrada ou excluir Agentes já adicionados à Caixa de Entrada. Você também pode ativar ou desativar a atribuição automática de novas conversas aos agentes adicionados a esta caixa de entrada. Clique em Atualizar para salvar as alterações. Guia Horário comercial Clique na guia Horário comercial . Nesta seção você pode definir o horário de trabalho da sua equipe associada à caixa de entrada do Twitter. Clique na caixa de seleção Ativar disponibilidade comercial para esta caixa de entrada se você tiver um horário comercial bem definido. Assim que a caixa de seleção estiver marcada, a seção abaixo será aberta. Você pode escrever sua mensagem para ser exibida ao cliente fora do horário comercial. Você também pode selecionar o horário comercial disponível para cada dia da semana e o fuso horário adequado. Clique no botão Atualizar configuração de horário comercial. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como funciona atendimento por voz na IAra

Use este guia quando você precisar configurar, entender ou validar Como funciona atendimento por voz na IAra na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado Fale com seus clientes por voz, direto da mesma caixa de entrada onde você já administra os chats. Este guia está dividido em três partes: 1. O que é chamada de voz e como ela ajuda: visão geral do recurso de chamada de voz 2. Conectando um canal de voz: configuração para cada provedor (Twilio e WhatsApp) 3. Usando chamadas de voz no dia a dia: atendimento, tarefas, quem liga e o que acontece depois de uma chamada 1. O que é chamada de voz e como ela ajuda As chamadas de voz permitem que seus agentes façam e recebam chamadas dentro da IAra, sem precisar usar um aplicativo de telefone separado. Uma chamada permanece no mesmo lugar que o restante da conversa, portanto, o histórico do bate-papo, os detalhes do contato, as notas e a chamada ficam todos juntos em uma linha do tempo. 1.1. Por que as equipes usam isso - Uma tela para tudo. Quando um cliente liga, o agente já vê quem ele é e o que falou antes, sem pedir que ele se repita. - Não há telefones para gerenciar. Os agentes conversam pelo navegador usando um fone de ouvido ou o microfone e os alto-falantes do computador. Não há sobrecarga adicional de novos softwares ou extensões de navegador. - Todas as chamadas ficam gravadas. Cada chamada se torna automaticamente uma mensagem na conversa, mostrando se foi atendida, quanto tempo durou, quem a atendeu e, quando disponível, uma gravação que você pode reproduzir e uma transcrição escrita que você pode ler. - A equipe compartilha a carga. Uma chamada recebida liga imediatamente para os agentes certos disponíveis, para que os clientes entrem em contato com uma pessoa real rapidamente. 1.2. Diferentes maneiras de receber uma chamada IAra oferece suporte a voz por meio de dois provedores. Você pode usar um ou ambos: | Provedor | Melhor para | Como a pessoa atendida chega até você | | -------------------- | --------------------------------- | ---------------------------------------------------------------------------- | | Voz Twilio | Uma linha telefônica comercial tradicional | A pessoa atendida disca seu número de telefone de qualquer telefone | | Chamadas pelo WhatsApp | Empresas já no WhatsApp | Cliente toca em “ligar” para sua empresa dentro do aplicativo WhatsApp | Observação: a chamada de voz é um recurso premium. Ele deve estar ativado em sua conta (o recurso Voice Channel ) antes que as opções abaixo apareçam. Se você não vir as configurações de voz, entre em contato com o administrador da sua conta ou com o provedor da IAra. 2. Conectando um canal de voz Configurar a voz é uma tarefa administrativa, realizada uma vez por caixa de entrada. Escolha a seção que corresponde ao provedor que você deseja. 2.1. Twilio Voice (uma linha de número de telefone) Siga este artigo para configurar o Twilio Voice: [Conectando o canal de voz do Twilio] 2.2. Chamadas pelo WhatsApp Siga este artigo para configurar as chamadas do WhatsApp: [Conectando o canal de voz do WhatsApp] Um requisito para os agentes: o navegador deve ter permissão de microfone concedida para a IAra. 3. Usando chamadas de voz no dia a dia Depois que uma caixa de entrada tiver a voz habilitada, as chamadas funcionarão da mesma maneira para os agentes, independentemente do provedor que estiver por trás delas. ###3.1. Recebendo uma chamada Quando um cliente liga, um widget de chamada flutuante aparece no canto da tela para os agentes que devem atender, e um toque é reproduzido. O cartão mostra o nome, número e (quando conhecido) do chamador sua localização, além de qual canal a chamada foi recebida. A partir desse widget, um agente pode: - Participar da chamada: atenda e comece a falar clicando no botão verde aceitar chamada. - Rejeitar: recuse a chamada (o chamador não está mais ligando para este agente) clicando no botão vermelho de rejeição de chamada. - Dispensar: oculta silenciosamente o pop-up nesta tela sem rejeitar a chamada, para que outros agentes ainda possam atendê-la. Você pode fazer isso clicando no botão de cruz no canto superior direito do widget. Se um colega de equipe (ou o mesmo agente em outra guia do navegador) já tiver atendido a chamada, o widget mostrará "Em atendimento em outra guia" para que duas pessoas não atendam a mesma chamada. Enquanto conectado, o widget mostra um cronômetro em execução e estes controles: - Desativar microfone/Ativar microfone: desligue e ligue o microfone do agente clicando no botão verde do microfone. - Encerrar chamada: desligue clicando no botão vermelho de encerrar chamada. - Ir para o tópico de conversa/Ver histórico de bate-papo: vá para a conversa completa enquanto permanece na chamada clicando no link "Ir para o tópico de conversa" na parte inferior do widget. Isso torna mais fácil para o agente ver o histórico anterior da conversa ou obter mais detalhes sobre o contato. ###3.2. Notificação e atribuições de chamadas A IAra liga para as pessoas com maior probabilidade de ajudar, mas não liga para todos cegamente. Para uma chamada recebida, ele toca nesta ordem de prioridade: 1. O agente designado, se a conversa já tiver um, somente ele será chamado. 2. Caso contrário, os agentes online nessa caixa de entrada, todos que estiverem disponíveis receberão a notificação de chamada de uma só vez. 3. Caso contrário, todos os administradores online da conta, como último recurso, para que nenhuma chamada fique sem resposta. Algumas regras que decorrem disso: - Apenas agentes disponíveis (on-line) recebem um pop-up tocando para chamadas recebidas. Os agentes que estão off-line ou ocupados são ignorados. - O primeiro a atender vence. Não há fila nem round-robin, quem atender primeiro atende a ligação, e para os demais para de tocar e a notificação da chamada desaparece. - A chamada é atribuída automaticamente a quem atende. A conversa passa a ser dele, portanto o acompanhamento fica com a pessoa que a atendeu. - As chamadas efetuadas sempre pertencem ao agente que as iniciou. ###3.3. Estados de chamada (o que os etiquetas significam) Cada chamada passa por um ciclo de vida simples e a conversa reflete isso: | O que você vê | Significado | | ---------------------------------------- | ---------------------------------------- | | Chamada recebida / Chamada efetuada | A chamada está tocando | | Chamada em andamento | Conectados e conversando | | Chamada encerrada | Concluído normalmente | | Sem resposta (Contato não atendido) | Chamada externa que a pessoa atendida não atendeu | | Chamada perdida (Nenhum agente atendeu) | Chamada recebida ninguém atendeu | | Recusado por {agente} | Um agente rejeitou a ligação | ###3.4. Depois da ligação Quando uma chamada termina, ela é salva como uma entrada de chamada na linha do tempo da conversa, para que haja um registro permanente. Dependendo da sua configuração, essa entrada pode incluir: - Resumo da chamada: direção (entrada/saída), o status final, quanto tempo durou e qual agente atendeu (por exemplo, "Você respondeu", "{agente} respondeu" ou "Eles responderam"). - Gravação: Para chamadas Twilio, uma gravação é capturada automaticamente e anexada para que você possa reproduzi-la. Para chamadas do WhatsApp, uma gravação é anexada quando disponível. - Transcrição: se sua conta tiver a transcrição de IA ativada (a integração da IAra, sujeita à cota disponível), a gravação será transformada em texto legível diretamente na entrada da chamada, com um botão Mostrar mais / Mostrar menos para chamadas longas. \ Uma chamada perdida ou recusada ainda deixa uma entrada (por exemplo, Chamada perdida - Nenhum agente atendeu), e o agente pode usar o Retorno de chamada da conversa para retorná-la. 3.5 Iniciando uma chamada externa Quando um agente perde uma chamada, a IAra oferece a capacidade de fazer um retorno de chamada para a pessoa atendida de forma integrada a partir do painel. Dentro de uma conversa, o agente pode usar o botão de chamada no cabeçalho da conversa: Você também pode iniciar uma chamada na tela de informações de contato. Solução rápida de problemas - Nenhuma configuração de voz aparece. O recurso Canal de voz não está ativado em sua conta. Pergunte ao seu administrador ou ao provedor da IAra. - As chamadas do WhatsApp não são ativadas. O número ainda não está registrado na API do WhatsApp Business Calling ou a caixa de entrada não é uma caixa de entrada do WhatsApp Cloud. Integre o número com Meta/seu provedor e tente novamente. - A chamada é conectada, mas não há som ou não inicia. Verifique se o navegador tem permissão de microfone para a IAra e se um fone de ouvido/microfone está selecionado. - Um cliente diz que não pode ligar para seu número do WhatsApp. Ele pode ainda não ter aceitado a solicitação de permissão de chamada. Ele receberá uma quando um agente tentar ligar, e as chamadas funcionarão assim que forem aceitas. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como conectar canal de voz via Twilio

Use este guia quando você precisar configurar, entender ou validar Como conectar canal de voz via Twilio na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado Com o Twilio Voice, os clientes ligam para um número de telefone real e os agentes atendem no navegador. O que você precisa da sua conta Twilio: - SID da conta e token de autenticação - Um SID de chave de API e um segredo de chave de API (tokens seguros para conectar cada agente à chamada) - Um aplicativo TwiML e um número de telefone da Twilio  Etapas para criar uma nova caixa de entrada do canal de voz 1. Na IAra, crie (ou abra) a caixa de entrada "Canal de voz" — Configurações → Caixas de entrada → Adicionar caixa de entrada → Canal de voz. \ 2. Insira seu número de telefone da Twilio e as credenciais da Twilio acima, insira seu "API Key SID" e "API Key Secret" e salve. \ 3. A IAra mostrará dois URLs: - URL de voz do Twilio - URL de retorno de chamada de status da Twilio 4. Copie-os e atualize-os no painel do Twilio: cole o "URL de voz do Twilio" nas configurações do número de telefone do Twilio e no aplicativo TwiML e cole o "URL de retorno de chamada de status do Twilio" no campo de retorno de chamada de status do seu número de telefone. Etapas para ativar o Voice em caixas de entrada existentes 1. Acesse a página de configurações da sua caixa de entrada. (Configurações > Caixas de entrada > {Nome da caixa de entrada}) 2. Abra a guia de configurações "Voz" da caixa de entrada e ative o botão de opção "Ativar chamada de voz". 3. A IAra mostrará dois URLs: - URL de voz do Twilio - URL de retorno de chamada de status da Twilio 4. Copie-os e atualize-os no painel do Twilio: cole o "URL de voz do Twilio" nas configurações do número de telefone do Twilio e no aplicativo TwiML e cole o "URL de retorno de chamada de status do Twilio" no campo de retorno de chamada de status do seu número de telefone. \ 5. Depois de salva, a caixa de entrada estará pronta para fazer e receber chamadas nesse número. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como conectar chamadas de voz do WhatsApp

Use este guia quando você precisar configurar, entender ou validar Como conectar chamadas de voz do WhatsApp na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado Com o WhatsApp Calling, os clientes ligam para o seu número comercial diretamente do aplicativo WhatsApp e os agentes atendem no navegador. Antes de começar: - A caixa de entrada deve ser uma caixa de entrada do WhatsApp Cloud (a API oficial do WhatsApp Cloud). As caixas de entrada do WhatsApp conectadas por meio de outros provedores (como 360dialog) não podem usar chamadas. - O número de telefone deve estar cadastrado na API do WhatsApp Business Calling. Caso contrário, a ativação da chamada falhará com uma mensagem solicitando que você integre o número primeiro ao Meta (ou ao seu provedor de soluções comerciais do WhatsApp). Etapas para ativar novas caixas de entrada: 1. Na IAra, crie a caixa de entrada "Canal de chamada do WhatsApp" — Configurações → Caixas de entrada → Adicionar caixa de entrada → Chamada do WhatsApp. \ 2. Faça o cadastro integrado para completar a integração da chamada de voz, uma vez feito isso a caixa de entrada estará pronta para fazer e receber ligações naquele número. \ Etapas para ativar caixas de entrada existentes: 1. Abra a guia de configurações "Chamadas" da caixa de entrada e ative "Ativar chamadas de voz". \ 2. Se a caixa de entrada estiver conectada por meio de inscrição incorporada: alterne o sinalizador de chamada de voz. Se a caixa de entrada estiver conectada por meio de teclas manuais, certifique-se de ativar a assinatura de web-hook de chamadas em developers.facebook.com. \ Observações sobre permissão/consentimento  O WhatsApp exige que a pessoa atendida permita o recebimento de chamadas. Se um agente tentar ligar para alguém que ainda não consentiu, a IAra envia uma solicitação de permissão em vez de fazer a chamada. Esta solicitação mostra "Enviou uma solicitação de permissão de chamada ao contato. Tente novamente assim que ele aceitar." Depois que o contato aceitar, as chamadas serão realizadas normalmente. (Se uma solicitação foi enviada recentemente, a IAra aguarda antes de enviar outra solicitação de chamada.) A mensagem de solicitação de permissão de chamada pode ser atualizada para enviar uma mensagem personalizada ao usuário e está disponível na guia Chamadas nas configurações da caixa de entrada. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como usar formulário pré-atendimento

Use este guia quando você precisar configurar, entender ou validar Como usar formulário pré-atendimento na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado O formulário pré-chat é usado para coletar informações sobre um contato/conversa antes de iniciar uma conversa. O formulário Pré-chat está disponível apenas no chat ao vivo do site. Como adicionar um formulário pré-chat? Etapa 1. Vá para Configurações → Caixas de entrada. Clique nas configurações específicas da caixa de entrada de um site. Etapa 2. Vá para a aba “Formulário Pré-Chat”. Existem dois tipos de campos possíveis no formulário pré-chat. 1. Campos padrão: Estes são os campos de contato principais ––E-mail, Número de telefone e Nome completo. 2. Campos personalizados: são os campos criados com . As configurações do formulário pré-chat listam os campos padrão e personalizados. As colunas nas configurações dos formulários pré-chat são descritas abaixo. - Chave Identificador exclusivo do campo - Tipo Tipo do campo (Texto, Lista, Número, Data, Link, Booleano) - Obrigatório O campo é obrigatório ou não - Etiqueta A etiqueta que será exibido ao visitante no widget - Espaço reservado O valor do espaço reservado Todos os campos seriam exibidos nas configurações do formulário pré-bate-papo por padrão. O administrador poderá fazer o seguinte. - Ativar/desativar campos - Altere a ordem dos campos - Atualizar etiqueta/espaço reservado - Habilitar/Desabilitar validação Personalize seu formulário pré-chat de acordo com suas necessidades. Para adicionar mais campos, adicione mais atributos personalizados. Como é um formulário pré-chat? Assim que o formulário pré-chat estiver habilitado, ele solicitará que seus clientes preencham um formulário como o mostrado abaixo ao iniciarem uma conversa por chat ao vivo. Além disso, leia: Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.