Outros tópicos
Por Stainen
Por Stainen
Guias e referências adicionais que não se encaixam nas principais categorias do produto.
Quais cookies são usados pelo Chatwoot?
Chatwoot utiliza os seguintes cookies. Widget de Chat cw_conversation: Este cookie permite que o Chatwoot mantenha a conversa quando o contato navega entre as páginas do site ou revisita o site posteriormente. cw_user_{identifier}: Este cookie é usado para armazenar em cache os detalhes do contato caso um contato seja identificado através do método da SDK setUser. Painel do Agente _chatwoot_session: Utilizado pelo painel do Super Admin do Chatwoot para manter a sessão do usuário. cw_d_session_info: Utilizado pelo Painel do Agente para armazenar a sessão do usuário autenticado.
Solução de problemas: Por que não estou recebendo notificações?
Se você não está recebendo notificações, siga estes passos um por um. 1. Certifique-se de que as notificações estão ativadas na sua conta Vá em Configurações de perfil → Notificações e ative os tipos desejados para E-mail e/ou Push. Se um tipo estiver desativado, o RockZap® não enviará notificações desse tipo. 2. Verifique se você está incluído naquela conversa Você só recebe certas notificações quando está conectado à conversa da forma correta: - Conversa criada: você deve ser colaborador daquela caixa de entrada. - Nova mensagem em conversa atribuída: a conversa deve estar atribuída a você. - Nova mensagem em conversa participando: você deve estar adicionado como participante. - Menção: alguém deve marcar/mentionar você em uma nota ou mensagem. Importante: - Se você não estiver atribuído e não for participante, não receberá notificações de “nova mensagem” para aquela conversa. - Uma menção pode notificar você mesmo que você ainda não fosse participante. 3. Verifique o status da conversa - Para conversas pendentes, o RockZap® não envia notificações de “Conversa criada” ou “Conversa atribuída”. - As notificações não são limitadas apenas às conversas “abertas”. 4. Verifique o tipo de mensagem - As notificações regulares de “nova mensagem” são enviadas apenas para mensagens normais de cliente/agente, não para notas privadas ou eventos de atividade. - Notas privadas geralmente não disparam notificações de nova mensagem regulares. - Mas se alguém mencionar você em uma nota privada, você ainda pode receber uma notificação de menção. 5. Se notificações Push estão faltando - Ative o push nas configurações de perfil do RockZap®. - Permita notificações nas configurações do seu navegador ou sistema operacional móvel. - Se a permissão do navegador/sistema estiver bloqueada, o push não chegará. 6. Se notificações por E-mail estão faltando - Confirme se as notificações por e-mail estão habilitadas para esse evento. - Confirme se seu e-mail está verificado.
Aplicativo móvel para Android
Você pode acessar sua conta do RockZap® através do aplicativo móvel Chatwoot em dispositivos Android. Como obter o aplicativo móvel Chatwoot para Android? Você pode baixar o aplicativo chamado "Chatwoot" na Play Store. Siga estes passos: 1. Abra a Play Store em seu dispositivo Android com a versão 7.0 ou superior. 2. Procure por Chatwoot e pressione "Instalar" para baixar o aplicativo. 3. Após o download, abra o aplicativo Chatwoot. 4. Insira a URL de Instalação; no formato domain.com. Se você estiver utilizando uma instalação auto-hospedada do Chatwoot, insira a URL do seu servidor. Caso contrário, use app.rockzap.com. 5. Clique no botão Conectar e insira suas credenciais de conta para fazer login. Contribua para testar atualizações do aplicativo Você pode se inscrever em nosso programa beta para ajudar a testar as atualizações do aplicativo antes do lançamento. Abra este link em seu dispositivo Android. Você pode sair do programa de testes Beta a qualquer momento clicando neste link enquanto estiver conectado com o endereço de e-mail do Google Play usado para participar do programa Beta. No link, clique em "Sair do programa".
Aplicativo móvel para iOS
Você pode acessar sua conta RockZap® em dispositivos móveis iOS através do aplicativo móvel Chatwoot. Como obter o aplicativo móvel Chatwoot para iOS? Você pode baixar o aplicativo chamado "Chatwoot" na App Store. Siga estes passos: 1. Abra a App Store no seu dispositivo Apple com iOS 11.0 ou superior. 2. Procure por Chatwoot e pressione "OBTER" para baixar o aplicativo. 3. Depois de baixado, abra o aplicativo Chatwoot. 4. Insira a URL da Instalação; no formato dominio.com. Se você estiver usando uma instalação Chatwoot auto-hospedada, insira a URL do seu servidor. Caso contrário, utilize app.rockzap.com. 5. Clique no botão Conectar e insira suas credenciais de conta para fazer login. Contribua para testar as atualizações do app Você pode se inscrever em nosso programa beta para ajudar a testar as atualizações do aplicativo antes do lançamento. Abra este link no seu dispositivo iOS. Você pode sair do programa de testes Beta a qualquer momento ao abrir o aplicativo TestFlight e clicar em "Parar de Testar".
Como forçar recarregamento na maioria dos navegadores
Um hard reload força seu navegador a ignorar o cache e buscar a versão mais recente de uma página da web diretamente do servidor. Isso é útil quando você está enfrentando problemas devido a arquivos em cache desatualizados. Veja como fazer isso em diferentes navegadores: Chrome Hard Reload - Windows/Linux: Pressione Ctrl + F5 - Mac: Pressione Cmd + Shift + R Hard Reload com Cache Desativado - Abra o DevTools (F12 ou Cmd + Option + I), clique com o botão direito no botão de recarregar e escolha "Esvaziar Cache e Fazer Hard Reload". Firefox Hard Reload - Windows: Pressione Ctrl + F5 ou Shift + F5 - Mac: Pressione Cmd + Shift + R Hard Reload com Cache Desativado - Abra o DevTools (F12), clique no ícone de configurações (engrenagem), marque "Desabilitar Cache" e recarregue a página. Edge Hard Reload - Pressione Ctrl + F5 Hard Reload com Cache Desativado - Abra o DevTools (F12), clique com o botão direito no botão de recarregar para "Esvaziar Cache e Fazer Hard Reload" (ou habilite "Desabilitar Cache" na aba de rede), então recarregue a página. Safari (Mac) - Pressione Cmd + Option + R
Idiomas compatíveis no RockZap®
O RockZap® oferece suporte nativo a mais de 30 idiomas diferentes. Este guia irá ilustrar como habilitar um idioma específico para funcionar com seu painel de controle e widget de chat ao vivo. Idiomas suportados Abaixo estão mencionados os idiomas suportados no RockZap® e seus respectivos códigos curtos (derivados de códigos de idioma ISO 639). (ar) العربية Català (ca) čeština (cs) dansk (da) Deutsch (de) ελληνικά (el) English (en) Español (es) فارسی (fa) suomi, suomen kieli (fi) Français (fr) magyar nyelv (hu) Bahasa Indonesia (id) Italiano (it) 日本語 (ja) 한국어 (ko) latviešu valoda (lv) മലയാളം (ml) Nederlands (nl) norsk (no) język polski (pl) Português (pt) Português Brasileiro (pt-BR) Română (ro) русский (ru) slovenčina (sk) Svenska (sv) தமிழ் (ta) ภาษาไทย (th) Türkçe (tr) українська мова (uk) Tiếng Việt (vi) 中文 (zh-CN) 中文 (台湾) (zh-TW) Como atualizar o idioma no widget de chat ao vivo? Conforme descrito no guia de configuração do SDK, você pode configurar o idioma local do widget de chat ao vivo passando o idioma em chatwootSettings ou chamando o método setLocale. Para especificar o idioma, use os códigos curtos fornecidos acima. Isso garantirá que o widget seja exibido no idioma desejado. // Passando pelo window.chatwootSettings window.chatwootSettings = { locale: 'pt_BR', // .. restante das configurações } // Usando o método setLocale window.$chatwoot.setLocale('pt_BR') Como atualizar o idioma do seu painel? Apenas administradores podem atualizar o idioma do painel. Vá até Configurações → Configurações da Conta. Você verá a opção Idioma do Site disponível nas opções. Selecione o idioma de sua preferência no menu suspenso correspondente. Clique no botão Atualizar Configurações no canto superior direito da sua tela. Alterar o idioma do site irá mudar o idioma padrão para todos os agentes/administradores do sistema. Atualmente, o Chatwoot não suporta a seleção de idioma no nível do agente. Além disso, observe que este idioma será utilizado como idioma de fallback para o widget de chat ao vivo.
Como ativar notificações push no seu navegador
Google Chrome: 1. Clique no menu de três pontos no canto superior direito e selecione Configurações. 2. Navegue até Privacidade e segurança > Configurações do site > Notificações. 3. Para garantir que as notificações possam ser ativadas, verifique se Os sites podem solicitar para enviar notificações está selecionado. 4. Para gerenciar sites específicos, use o botão Adicionar em Permitir ou Bloquear para inserir a URL do site. Alternativamente, clique no ícone de cadeado na barra de endereços enquanto estiver em um site, selecione Configurações do site e ajuste a permissão de Notificações. Mozilla Firefox: 1. Clique no botão de menu (três linhas horizontais) e selecione Configurações. 2. Vá para Privacidade e Segurança. 3. Em Permissões, encontre Notificações e clique em Configurações. 4. Aqui, você pode gerenciar permissões para cada site ou desmarcar Bloquear novas solicitações para permitir notificações para garantir que os prompts sejam exibidos. Safari (macOS): 1. Clique em Safari no menu superior e selecione Preferências. 2. Vá para a guia Sites e selecione Notificações. 3. Aqui, você pode permitir ou negar permissões de notificação para cada site listado. Certifique-se de que Permitir sites pedirem permissão está ativado. Microsoft Edge: 1. Clique no menu de três pontos no canto superior direito e selecione Configurações. 2. Navegue até Cookies e permissões do site > Notificações. 3. Para bloquear todas as notificações, desative a opção Perguntar antes de enviar. 4. Para gerenciar sites específicos, use o botão Adicionar em Permitir ou Bloquear para inserir a URL do site. Alternativamente, clique no ícone de cadeado na barra de endereços enquanto estiver em um site, selecione Permissões para este site e ajuste a configuração de Notificações. Caso queira uma documentação mais detalhada, seguem os links para os documentos sobre como ativar notificações push nos navegadores mais populares. 1. Chrome ou navegadores baseados em chrome como Brave e Edge 2. Safari 3. Firefox
Inconsistências nos números do WhatsApp no Brasil e na Argentina
Nos últimos anos, alguns países alteraram seus sistemas de numeração móvel para acomodar o crescimento. Essas mudanças criaram inconsistências entre o número que você pode discar hoje e o número que o WhatsApp armazenou para contas antigas. - Brasil: Um "9" foi adicionado após o código de área a todos os números de celular, criando um formato total de 13 dígitos. Exemplo: +55 11 9 8765-4321 em vez de +55 11 8765-4321. - Argentina: Números podem aparecer com ou sem um "9" após o código do país, dependendo de quando a conta do WhatsApp foi registrada. Exemplo: +54 9 11 1234-5678 vs +54 11 1234-5678. Por conta disso, quando o Chatwoot inicia uma conversa no WhatsApp (usando o formato “correto” para discagem), o WhatsApp pode responder com o número antigo registrado do usuário. Isso pode criar contatos duplicados e atrapalhar o fluxo de tickets na sua caixa de entrada. Infelizmente, esse problema vem do próprio WhatsApp. Não há solução no nível da API, e é improvável que o WhatsApp atualize contas antigas para coincidir com as novas regras de numeração. Como o Chatwoot resolve isso Adicionamos uma lógica para evitar automaticamente contatos e tickets duplicados quando essas discrepâncias ocorrem: - Caso 1: Mensagem recebida com número no novo formato (exemplo: código do país +55 + código de área + 9 + número, total de 13 dígitos) → Nenhuma alteração necessária. A mensagem é vinculada diretamente ao contato existente. - Caso 2: Mensagem recebida com número no formato antigo (exemplo: código do país +55 + código de área + número, total de 12 dígitos, sem o dígito extra) → O Chatwoot verifica se já existe um contato no novo formato. → Se existir, vinculamos a mensagem ao contato correto em vez de criar um duplicado. O que isso significa para você - Você ainda pode perceber a diferença de como os números aparecem no WhatsApp e como aparecem no seu CRM. - Você pode continuar conversando normalmente com seus clientes — o Chatwoot cuida do descompasso em segundo plano - O Chatwoot normaliza automaticamente os números de telefone dos dois formatos (antigo e novo) nos bastidores para garantir que a correspondência de contatos seja consistente, independentemente do formato que o WhatsApp retornar.
Migrar uma caixa de entrada de Inscrição Incorporada do WhatsApp para configuração manual
Este guia ajuda você a migrar uma caixa de entrada existente do WhatsApp Cloud para a configuração manual no RockZap®. A migração mantém sua caixa de entrada existente intacta. Conversas, contatos, colaboradores, regras de roteamento, horários de atendimento, configurações de CSAT, configurações de bot e outras configurações da caixa de entrada são preservadas. Números do WhatsApp com suporte à Coexistência estão atualmente sob análise. Se o seu número do WhatsApp também é usado no WhatsApp Business App, entre em contato com o Suporte RockZap® antes de iniciar essa migração. Antes de iniciar a migração, reúna os detalhes necessários da API do WhatsApp Cloud da Meta: WABA ID, ID do Número de Telefone e um token de acesso permanente de usuário do sistema. Use as etapas abaixo para criar ou selecionar um app Meta, adicionar ou selecionar o número do WhatsApp e gerar o token. Obtenha seus detalhes da API do WhatsApp Cloud na Meta Para concluir a migração, você precisará de três informações da Meta: - ID da Conta Comercial do WhatsApp - ID do Número de Telefone - Token de acesso permanente ou token de usuário do sistema Você pode obter o ID da Conta Comercial do WhatsApp e o ID do Número de Telefone no seu app Meta. Crie ou selecione um app Meta Acesse Meta for Developers e selecione um app existente ou clique em Create App. Se estiver criando um novo app, insira um nome para o app e um e-mail de contato, depois clique em Next. Escolha o caso de uso do WhatsApp Na tela de seleção de caso de uso, escolha Connect with customers through WhatsApp e clique em Next. Escolha um portfólio de negócios Selecione o portfólio de negócios que possui ou possuirá sua Conta Comercial do WhatsApp. Se você ainda não tiver um portfólio de negócios, poderá criar um nesta etapa ou continuar e criá-lo depois, se a Meta permitir. Revise os requisitos de publicação A Meta pode mostrar requisitos de publicação para o app e caso de uso selecionados. Revise os requisitos e clique em Next. Revise e crie o app Revise os detalhes do app, o caso de uso do WhatsApp selecionado e o portfólio de negócios conectado. Clique em Create app para finalizar. Abra a configuração da API do WhatsApp Depois que o app for criado ou selecionado: 1. Clique em Use cases na barra lateral. 2. Encontre Connect with customers through WhatsApp. 3. Clique em Customize. 4. Clique em API Setup. Na nova interface do app Meta, vá para Basic setup → Step 2. Production setup e abra Register your WhatsApp phone number. Em apps Meta antigos, abra WhatsApp → API setup na barra lateral esquerda. Adicione ou selecione seu número do WhatsApp Na seção Send and receive messages ou Register your WhatsApp phone number, escolha um número existente no seletor From, ou clique em Add phone number. Se estiver adicionando um novo número: 1. Insira o nome de exibição do seu negócio no WhatsApp e os detalhes do negócio. 2. Insira o número de telefone. 3. Escolha a verificação por SMS ou ligação telefônica. 4. Insira o código OTP da Meta para verificar o número. Copie os IDs necessários Após adicionar ou selecionar o número, copie estes valores da página de configuração da API: - Phone Number ID - WhatsApp Business Account ID Você precisará colar esses valores durante o fluxo de migração do RockZap®. Na interface antiga do Meta, esses valores aparecem diretamente abaixo do seletor From em WhatsApp → API setup. A Meta altera esta interface com frequência. Se sua tela estiver diferente, procure pela página de configuração da API do WhatsApp e pelo número do remetente selecionado. O Phone Number ID e o WhatsApp Business Account ID geralmente são exibidos próximos ao telefone From selecionado. Configure um token de acesso permanente da API do WhatsApp Cloud Você também precisa de um token permanente de usuário do sistema com permissões do WhatsApp. Esse token permite que o RockZap® conecte-se ao seu número da API do WhatsApp Cloud, envie e receba mensagens e sincronize templates de mensagens. Abra usuários do sistema nas Configurações de Negócios da Meta 1. Abra as Configurações de Negócios da Meta. 2. Selecione o portfólio de negócios que possui sua Conta Comercial do WhatsApp. 3. Vá para Users → System users. 4. Se você já possui um usuário do sistema para o RockZap®, selecione-o. 5. Se não tiver, clique em Add. Crie um usuário do sistema 1. Insira um nome para o usuário do sistema, como rockzap WhatsApp. 2. Selecione Admin como a função do usuário do sistema. 3. Clique em Create system user. Gere um token 1. Selecione o usuário do sistema. 2. Clique em Generate token. Selecione o app Meta Escolha o app Meta que você criou ou selecionou anteriormente para a configuração da API do WhatsApp Cloud, depois clique em Next. Defina a expiração do token Selecione Never como expiração do token e clique em Next. Atribua permissões Selecione as permissões necessárias do WhatsApp: - whatsapp_business_messaging - whatsapp_business_management - whatsapp_business_manage_events Em seguida, continue para gerar o token. Copie o token Depois que a Meta criar o token, clique em Copy e armazene-o com segurança. Você irá colar este token na etapa Access token no fluxo de migração do RockZap®. Mantenha este token privado. Qualquer pessoa com acesso a ele pode usar sua conexão da API do WhatsApp Cloud. Inicie a migração 1. Vá para Settings → Inboxes. 2. Abra a caixa de entrada do WhatsApp conectada via cadastro incorporado. 3. Clique em Start manual migration. O RockZap® abrirá um fluxo guiado de migração. Passo 1: Revise o que será alterado A primeira etapa explica o que será preservado e o que será atualizado. Preservado: - Conversas - Contatos - Colaboradores - Roteamento - Horário de atendimento - Configurações da caixa de entrada Atualizado: - WABA ID - Phone Number ID - Access token - Configuração do Webhook Clique em Continue. Passo 2: Insira os detalhes do negócio Insira os dados do ativo WhatsApp obtidos na Meta. Campos: - WABA ID: A Conta Comercial do WhatsApp que possui este número de telefone. - Phone Number ID: O ID exclusivo da Meta para o número do WhatsApp conectado a esta caixa de entrada. - Display phone number: O número do WhatsApp exibido para o cliente. Este não pode ser alterado durante a migração. Clique em Continue. Passo 3: Adicione o token de acesso Cole um token de acesso permanente ou token de usuário do sistema com permissões do WhatsApp. O token deve incluir whatsapp_business_messaging, whatsapp_business_management e whatsapp_business_manage_events. Passo 4: Revise e reconecte Revise a caixa de entrada, o número de telefone, o WABA ID e o Phone Number ID antes de aplicar as alterações. O RockZap® verificará as credenciais com a Meta antes de aplicar as alterações. Se a verificação falhar, a configuração atual permanecerá inalterada. Clique em Reconnect WhatsApp inbox para concluir a migração. Após a migração Após a migração ser concluída, a caixa de entrada permanece igual no RockZap® , mas a conexão do WhatsApp passa a usar a configuração manual da API do WhatsApp Cloud. Você deve verificar: - Mensagens recebidas - Respostas enviadas - Envio de mensagens de template - Sincronização de template - Entrega do webhook Precisa de ajuda? Se você tiver dúvidas sobre qualquer etapa, entre em contato com o Suporte RockZap®. Podemos te ajudar a verificar os detalhes necessários da Meta e auxiliar na migração.