Bem-vindo ao guia do Contact Hub do Interakt. A aba Contact Hub é a sua agenda de contatos inteligente, onde você e sua equipe podem criar, atualizar e gerenciar seus contatos no Interakt. Neste módulo, vamos entender o processo de atualização dos atributos de contato de um cliente já existente. Mas antes de entrarmos no processo, vamos começar pela aba Contact Hub.
O que é o Contact Hub?
A aba Central de Contatos é a sua agenda de contatos inteligente, onde você e sua equipe podem criar, atualizar e gerenciar seus contatos no Interakt. Acesse o CRM de Vendas e clique em Central de Contatos.
. Você pode personalizar ainda mais essas colunas e exibir detalhes relevantes para o seu negócio. Para fazer isso, você precisa clicar no botão no canto direito para adicionar ou remover colunas dos itens que já estão exibidos aqui.
Você pode obter uma visão geral de todos os seus contatos comerciais no painel de controle aqui.
Como atualizar os atributos de contato existentes por meio do Contact Hub?
Para editar os atributos dos usuários existentes no Interakt, basta clicar no nome do usuário e você será direcionado para o painel com todos os detalhes. Lá, você pode alterar informações como endereço de e-mail ou nome clicando no ícone de lápis.
Observe que você pode alterar todos os atributos, exceto o número de telefone.
Por exemplo, existe um usuário com o número de telefone 9876543210 e o nome Ajmal. Se você quiser alterar o nome desse usuário para Abel, basta clicar no ícone de lápis e fazer a alteração. O sistema atualizará o nome do usuário 9876543210 de Ajmal para Abel.
Você pode personalizar ainda mais essas colunas e exibir detalhes relevantes para o seu negócio. Para isso, clique no botão Editar ou em + Adicionar Campo na parte inferior para adicionar ou remover detalhes dos itens já exibidos.
Agora, suponha que você queira alterar o único atributo chamado 'Cidade', então você pode simplesmente clicar em editar e adicionar/alterar o nome da cidade.
Agora, se você não encontrar um campo para adicionar os detalhes relevantes ao seu contato, pode facilmente adicionar um novo campo clicando no botão +Adicionar Campo. Em seguida, basta adicionar o campo desejado e salvar.
Como atualizar contatos por meio de upload em massa
Passo 1: Prepare seu arquivo CSV
Antes de fazer o upload, certifique-se de que seus dados estejam organizados em um CSV (valores separados por vírgula) Seu arquivo deve incluir cabeçalhos essenciais, como:
- Nome completo
- Número de telefone (incluindo o código do país)
- Quaisquer outros atributos personalizados que você deseje rastrear.
Etapa 2: Carregar o arquivo e gerenciar as tags
Acesse a seção de upload e selecione o arquivo CSV que você preparou. Nesta etapa, você precisará categorizar esses contatos usando as Tags:
Etiquetas padrão: escolha na lista preexistente de etiquetas comuns.
Etiquetas personalizadas: Clique em “+Ver mais” para pesquisar uma etiqueta personalizada existente ou criar uma totalmente nova. Uma janela pop-up será exibida, permitindo que você digite e salve seus identificadores exclusivos.
Passo 4: Confirme o envio
Após verificar se todos os atributos estão mapeados corretamente para suas respectivas categorias, clique em Confirmar. Seus contatos serão atualizados no sistema com os novos atributos e tags.
Dica: Sempre verifique se seus números de telefone incluem o sinal de “+” e o código do país para evitar erros de upload.
Algumas práticas recomendadas para upload em massa de dados do cliente
• Arquivo máximo permitido de 50 MB, ou seja, até Contatos 500000
• O CSV deve conter obrigatoriamente o número de telefone e o código do país em 2 colunas quaisquer.
• Se dois (ou mais) contatos em CSV tiverem o mesmo número de telefone, eles poderão não ser adicionados.
• Se já existir um contato no CSV em sua conta, as características do contato existente serão atualizadas de acordo com as características fornecidas no CSV. (a correspondência de contatos é feita com base no número de telefone)
• Para atualizar o status de WhatsApp optado de um cliente, inclua uma coluna intitulada WhatsApp optado e insira VERDADEIRO ou FALSO como valores da coluna.
• Para adicionar uma característica do tipo DateTime (por exemplo: data_de_nascimento, data_do_último pedido etc.), forneça valores de coluna no formato ISO. Por exemplo - se você deseja passar a data e hora 31 de outubro de 2022 às 7h30 IST, você pode fazê-lo em qualquer um dos formatos abaixo:
1.2024-10-31T19:30:00.000+05:30
2.2024-10-31T14:00:00Z
3.2024-10-31
Como adicionar/atualizar detalhes do usuário no Interakt por meio de APIs de rastreamento de usuário
A API de rastreamento de usuário permite que os clientes registrem os atributos específicos do usuário. Eles podem registrar propriedades (atributos) específicas do usuário, como ID do usuário, ID de e-mail, número de telefone, nome, etc. Os clientes podem chamar a API de rastreamento de usuário quando uma nova conta de usuário é criada em seu site/aplicativo/CRM. Por exemplo:
Para adicionar um novo usuário ao seu painel do Interakt, a seguinte carga poderia ser enviada na chamada da API:
POST https://api.interakt.ai/v1/public/track/users/
{
“userId”: “0123abc45d”,
“phoneNumber”: “9967536783”,
“countryCode”: “+91”,
“traits”: {
“name”: “Gavin Roberts”,
“email”: “gavinroberts01@outlook.com”,
“dob”: “1996-12-01”,
“Sample trait a”:”value y”
}
}
Os diferentes atributos do usuário (traços) podem ser dos seguintes tipos de dados: String, Números, Booleano, Datahora, Lista. Confira as diferentes opções de filtros disponíveis no Interakt, para diferentes tipos de características – link.
Observação**: Especificando o ID do usuário or phoneNumber (com countryCode) is Obrigatório
A chamada de API acima registra “userId” ou “phoneNumber” (com “countryCode”) como um identificador exclusivo para o usuário e também adiciona atributos como nome, email, data de nascimento.
Para atualizar os atributos do usuário acima, A seguinte carga útil poderia ser enviada na chamada da API: (suponha que o atributo “dob” precise ser alterado para “1997-12-01”).
POST https://api.interakt.ai/v1/public/track/users/
{
“userId”: “0123abc45d”,
“phoneNumber”: “9967536783”,
“countryCode”: “+91”,
“traits”: {
“dob”: “1997-12-01”
}
}
Para adicionar um novo atributo para o usuário acima, a seguinte carga útil pode ser enviada na chamada da API: (suponha que o atributo "código PIN" precise ser adicionado).
POST https://api.interakt.ai/v1/public/track/users/
{
“userId”: “0123abc45d”,
“phoneNumber”: “9967536783”,
“countryCode”: “+91”,
“traits”: {
“Pin code”: “400001”
}
}
Agora você pode adicionar tags aos seus clientes no Interakt por meio de APIs.
Basta incluir uma chave para “tags” na chamada da API User Track.
Exemplo de carga útil:
{
“phoneNumber”: “9967536783”,
“countryCode”: “+91”,
“traits”: {
“name”: “Gavin Roberts”,
“email”: “gavinroberts01@outlook.com”
},
“tags”: [“new customer”, “potential lead”]
}
• Você pode adicionar várias tags.
• Você só pode adicionar novas etiquetas. Não é possível excluir etiquetas existentes.
• A adição de etiquetas não diferencia maiúsculas de minúsculas, ou seja, se você adicionar a etiqueta 'novo cliente' ao Cliente A e a etiqueta 'Novo Cliente' já existir no Cliente A, nenhuma nova etiqueta será adicionada ao Cliente A.









