Use este guia quando você precisar configurar, entender ou validar **Entendendo contatos 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 A seção “Contatos” na IAra serve como um banco de dados de pessoas atendidas ou clientes com quem você interagiu por meio do widget IAra. Você também pode fazer upload de contatos manualmente. **Na tela:** A tela de contatos centraliza dados, histórico e caminhos de segmentação. ![contatos.](https://app.digi2b.com/storage/file/2wirp0bpxjc67p42nu6tx4d59mxi) **Para visualizar a tela Contatos, clique na guia “Contatos” na barra lateral esquerda** do seu painel. Esta é a aparência de uma tela de contatos típica: ## Como adicionar contatos? Os contatos podem ser adicionados à lista de três maneiras, conforme explicado nas seções a seguir. ### Carregamento manual Você pode fazer upload manual de contatos para seu banco de dados de clientes IAra de duas maneiras. 1. **Adicione um único contato** **Etapa 1.** Na tela Contatos, clique no botão “**Novo contato**” no canto superior direito. **Etapa 2.** Comece a preencher os dados de contato disponíveis com você. Clique em “Enviar”. 2. **Importe um banco de dados de contatos** **Etapa 1.** Na tela Contatos, clique no botão “**Importar**” no canto superior direito. **Etapa 2.** Escolha um arquivo CSV do seu sistema para carregá-lo no banco de dados IAra. Esta é a aparência de um banco de dados de exemplo: ### Formulários pré-chat Se você tiver um formulário pré-chat ativado, toda vez que um cliente fornecer seu e-mail e outros detalhes por meio dele, a IAra irá salvá-lo como um novo contato. No exemplo compartilhado acima, Raji Nair será salva automaticamente como contato ao preencher o formulário pré-bate-papo. ### Saudação do canal Sempre que um cliente inserir seu ID de e-mail na mensagem de saudação do canal, ele será salvo automaticamente como contato. ## Contatos agrupados por etiquetas Você pode filtrar seus contatos por etiquetas. Basta selecionar uma etiqueta da sua lista de “**Tagged with**”, conforme mostrado abaixo. ## Classificando contatos Para organizar seus contatos, clique no ícone com duas setas em qualquer coluna. A seguir explica-se a lógica por trás da classificação da etiqueta de cada coluna. * Classificar por nome: Classifica a lista em ordem alfabética. * Classificando por e-mail: Classifica a lista em ordem alfabética. * Classificando por número de telefone: ordena a lista em ordem numérica. * Classificando por nome da empresa: Classifica a lista em ordem alfabética. * Classificando por cidade: Classifica a lista em ordem alfabética. * Classificando por país: Classifica a lista em ordem alfabética. * Classificando pela última atividade: Classifica a lista cronologicamente. ## Ações de contato Você pode executar ações específicas em um contato. Para visualizar essas ações, clique no nome de um contato. Irá abrir uma barra lateral com os detalhes desse contato e ações associadas, conforme ilustrado na imagem abaixo. ### Ação – Envie uma nova mensagem Você pode enviar mensagens para um contato usando o botão “Nova mensagem”, conforme ilustrado na imagem acima. Você pode enviar mensagens de sua página de contato para os seguintes canais de conversa. * Website (apenas para contactos identificados pelo HMAC) * E-mail *SMS * WhatsApp ## Notas de contato Você pode adicionar notas e informações importantes a um contato específico. Você pode usar isso para registrar manualmente uma chamada, e-mail ou reunião com a pessoa atendida. Para adicionar notas:**** 1. Clique no item de menu Contatos no painel da IAra. 2. Selecione um contato na lista. (Clique no nome do contato) 3. Escreva sua nota. 4. Clique no botão "Adicionar" ou pressione `Cmd + Enter`. Visite a página de contato individual. Você também pode usar formatação rich text em suas notas e excluí-las conforme necessário. ## Filtrando Contatos Use filtros para agrupar seus contatos e categorizar dados. Para começar a filtrar contatos, siga as etapas descritas abaixo. **Etapa 1.** Clique no botão “Filtrar” na parte superior da tela de contatos. **Etapa 2.** Selecione um filtro no menu suspenso e selecione “Igual a” ou “Diferente de”, conforme aplicável. Você pode aplicar filtros avançados aos seus contatos. Os seguintes filtros estão disponíveis: 1. Nome do contato 2. E-mail de contato 3. Número de telefone 4. Identificador de contato 5. País 6. Cidade 7. Criado em 8. Última atividade 9. Atributos personalizados adicionados à sua conta **Etapa 3.** Adicione mais filtros usando operadores AND/OR se necessário. **Etapa 4.** Pressione o botão “Enviar”. Você será redirecionado de volta para a tela Contatos e verá apenas os contatos qualificados pelos filtros selecionados. ### Salvando um filtro como segmento de contato Uma lista filtrada de contatos mostra uma opção para “Salvar filtro” na parte superior da tela. Salvar um filtro pode ajudá-lo a revisitá-lo com um único clique. **Etapa 1.** Clique no botão “**Salvar filtro**”. **Etapa 2.** Dê um nome ao seu filtro e clique no botão “**Salvar filtro**”. Aqui está um exemplo: Para acessar um segmento de contato posteriormente, clique nele na barra lateral dos seus contatos. ### Editando ou revertendo um filtro Para editar ou limpar os filtros e voltar à lista original, siga estes passos: **Etapa 1.** Clique no botão “Filtrar”. **Etapa 2.** O pop-up será aberto. Aqui, você pode editar os filtros existentes usando os menus suspensos. Você também pode adicionar filtros ou limpar todos eles para voltar à lista de contatos original. Clique em “**Enviar**”. --- ## 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.