# Contatos (SyBox)

Onde: Definições > Equipe e clientes > Contatos

Para que serve:

Esta tela importa clientes de um arquivo CSV ou Excel, exporta seus clientes para um arquivo CSV, sincroniza os nomes dos clientes a partir do Google Contatos e remove contatos inativos que nunca enviaram ou receberam mensagens.

Quem pode acessar:

Usuários que têm a permissão "Gerenciar configurações da organização". Para importar, também é necessário ter "Mostrar o número do contato". Para exportar, também são necessárias "Ver o diretório de contatos" e "Mostrar o número do contato".

### Como importar contatos de um arquivo

1. Vá em Configurações > Contatos. Em "Importar contatos de um arquivo", clique em "Escolher um arquivo".
2. Escolha um arquivo CSV ou um arquivo do Excel (.xlsx). Cada linha corresponde a um cliente. Em um arquivo do Excel, a primeira planilha é lida. O arquivo pode conter até 20.000 linhas. Um arquivo CSV salvo pelo Excel é lido corretamente, inclusive nomes em árabe, tenha sido salvo como "CSV UTF-8" ou como "CSV" comum.
3. Deixe a opção "A primeira linha contém os nomes das colunas" marcada se a primeira linha tiver títulos como "Nome" e "Telefone". Desmarque-a se a primeira linha já for um cliente.
4. Em "País dos números escritos sem código do país", escolha o país dos números locais, como 01001234567. Os números escritos com código do país (+20…, 0020… ou 20…) são lidos como estão. O país do seu espaço de trabalho vem selecionado inicialmente.
5. Em "O que cada coluna contém", escolha o que cada coluna guarda: "Nome", "Número de telefone", "E-mail", "Etiquetas", "Departamentos", um dos seus campos de contato ou "Não importar". O SyBox preenche essas opções a partir dos títulos das colunas quando possível. Cada opção só pode ser usada em uma única coluna. Uma coluna de número de telefone é obrigatória.
6. Para substituir os nomes e e-mails que seus clientes já têm no SyBox, marque "Substituir nomes e e-mails que já estão salvos". Caso contrário, um nome ou e-mail importado só preenche campos vazios. A substituição exige a permissão "Editar contato"; sem ela, apenas nomes e e-mails vazios são preenchidos.
7. Clique em "Verificar o ficheiro". Nada é salvo ainda. Você vê quantos clientes são novos, quantos já estão no SyBox e serão atualizados e quantas linhas têm algum problema. Uma tabela mostra as primeiras linhas e todas as linhas com problema.
8. Clique em "Importar". Somente as linhas aceitas na verificação são salvas. O progresso aparece durante a execução e um resumo é exibido ao final.
9. Para corrigir as linhas que não foram importadas, clique em "Baixar as linhas com problema", corrija-as no arquivo e importe esse arquivo novamente.

O que a importação faz:

- Um número que já está no SyBox é atualizado. Ele nunca é adicionado uma segunda vez, e sua conversa e seu histórico permanecem como estão.
- Um número novo ganha um cadastro de cliente próprio, pronto para uma conversa.
- Etiquetas e departamentos são somados ao que o cliente já possui; nada é removido. Escreva vários na mesma célula separados por vírgulas, por exemplo "VIP, Cairo". Cada um já deve existir com o mesmo nome (em qualquer um dos idiomas) em Configurações > Etiquetas ou Configurações > Departamentos. Você só pode adicionar departamentos que tenha permissão para atribuir. Etiquetas e departamentos exigem a permissão "Editar contato", e etiquetas também exigem "Atribuir rótulos ao contato"; sem elas, essas colunas são ignoradas.
- Os campos de contato seguem o tipo do campo: um número para um campo numérico, uma data (2026-11-06 ou 6/11/2026) para um campo de data, uma das opções para uma lista suspensa e sim ou não para um campo de sim / não.
- Uma célula vazia nunca apaga nada.

Problemas que uma linha pode ter:

- "Não é um número de telefone válido": o número está incompleto, ou está sem código do país e o país escolhido não corresponde a ele.
- "Este número já está em uma linha anterior": o mesmo cliente aparece duas vezes no arquivo. A primeira linha é importada.
- "Nenhuma etiqueta com este nome" / "Nenhum departamento com este nome": o nome no arquivo não corresponde a nenhuma etiqueta ou departamento. O restante da linha ainda é importado.
- "Você não pode adicionar clientes a este departamento": suas permissões não permitem atribuí-lo.
- "Este valor não corresponde ao campo": a célula não condiz com o tipo daquele campo de contato. O restante da linha ainda é importado.
- "Não é um endereço de e-mail válido": o e-mail é ignorado. O restante da linha ainda é importado.
- "Este cliente está fora das conversas que você pode ver": o número pertence a um cliente que suas permissões não abrangem. A linha não é importada.

### Como exportar seus contatos

1. Vá em Configurações > Contatos. Em "Exportar contatos", clique em "Baixar CSV".
2. O SyBox prepara o arquivo e mostra quantos contatos já foram adicionados até o momento. Em seguida, o arquivo é baixado.
3. O arquivo tem uma linha para cada cliente que você tem permissão para ver: nome, número de telefone, e-mail, canal, país, etiquetas, departamentos, data em que o cliente foi adicionado, data da última mensagem e uma coluna para cada campo de contato. As datas seguem o fuso horário do país do seu espaço de trabalho.
4. Abra-o no Excel ou no Google Sheets. Os números de telefone são gravados com o código do país e sem o sinal "+", para que um arquivo exportado possa ser importado novamente.

Sincronização com o Google Contatos (se disponível no seu espaço de trabalho):

### Como conectar o Google Contatos

1. Vá para Definições > Contatos.
   ![Settings, Contacts: the "Connect Google Contacts" button](https://www.sybox.io/res/sybox/help/pt/connect-google-contacts-1.webp?v=96d7df80)
2. Clique em "Conectar contatos do Google".
3. Você será direcionado para o Google. Escolha sua conta Google e autorize o acesso aos seus contatos.
4. Ao retornar ao SyBox, o e-mail da conta Google conectada será exibido com uma marca de seleção verde.

### Como sincronizar

- "Sincronizar contatos agora" importa todos os contatos do Google que possuam um número de telefone internacional válido. Novos contatos são criados e nomes ausentes são completados. Nomes já editados pela sua equipe no SyBox nunca são substituídos. Ao concluir, você verá "Contatos sincronizados" informando a quantidade.
- "Atualizar apenas os nomes" apenas preenche os nomes que estiverem em branco para números que já existem no seu espaço de trabalho. Não adiciona novos contatos. Ideal para quando sua agenda do Google tem muitos contatos pessoais que você não deseja trazer para o SyBox. Ao concluir, exibe "Nomes atualizados" com a quantidade.

### Como desconectar o Google Contatos

1. Clique em "Desconectar".
2. Leia a mensagem de aviso e confirme. O SyBox para de sincronizar e o acesso também é revogado na sua conta Google.
3. Os contatos já importados permanecem no seu espaço de trabalho. Você pode reconectar a integração quando quiser.

### Como excluir contatos inativos

1. Clique em "Excluir contatos não utilizados".
   ![Settings, Contacts: the red "Delete unused contacts" button](https://www.sybox.io/res/sybox/help/pt/delete-unused-contacts-1.webp?v=3962c612)
2. O SyBox faz a contagem de contatos sem histórico de mensagens em nenhum dos canais (WhatsApp, SMS, e-mail, Messenger, Instagram).
3. Se não houver nenhum, a mensagem "Contatos não utilizados excluídos (0)" será exibida e nada mudará.
4. Se houver contatos inativos, a tela de confirmação mostrará a quantidade. Confirme para excluí-los.
5. Esta exclusão é definitiva e não pode ser revertida.

**Q: A sincronização com o Google Contatos vai sobrescrever nomes que minha equipe já cadastrou?**

Não. Nomes definidos manualmente pela sua equipe nunca são alterados.

**Q: Quero apenas atualizar o nome dos clientes que já tenho, sem importar a agenda inteira.**

Utilize a opção "Atualizar apenas os nomes".

**Q: A seção do Google Contatos não aparece para mim.**

Essa opção só é exibida se o recurso estiver habilitado para o seu espaço de trabalho.

**Q: Não vejo "Importar contatos de um arquivo" nem "Exportar contatos".**

Para importar é necessário "Mostrar o número do contato". Para exportar são necessários "Ver o diretório de contatos" e "Mostrar o número do contato". Peça ao seu administrador.

**Q: A importação criará clientes duplicados?**

Não. Um número que já existe no SyBox é atualizado, mesmo quando o arquivo o escreve de forma diferente (com espaços, com um 0 à esquerda ou com 00 no lugar de +).

**Q: Meu arquivo do Excel mostra os números de telefone como 2.01E+11.**

É assim que o Excel exibe um número longo em uma coluna estreita. O número completo continua na célula e o SyBox o lê por inteiro. Aumente a largura da coluna para vê-lo.

Source: https://www.sybox.io/pt/help/contacts