Contatos
A lista de contatos é a base das campanhas. Cada contato tem telefone, nome, campos personalizados, etiquetas e a marcação de opt-out.
Formato do telefone
Os telefones são guardados só com dígitos, com DDI e DDD: 5583999991234. Espaços, parênteses e traços são removidos na importação, e números brasileiros sem DDI recebem o 55 automaticamente. O telefone é a chave do contato: importar o mesmo número de novo atualiza o cadastro em vez de duplicar.
Importar CSV
Em Contatos → Importar, envie um arquivo CSV com cabeçalho na primeira linha.
| Coluna | Obrigatória | Uso |
|---|---|---|
telefone ou phone | Sim | Número do contato. |
nome ou name | Não | Nome usado em {{nome}} e {{primeiro_nome}}. |
| Qualquer outra | Não | Vira um campo personalizado e pode ser usada como variável, por exemplo {{cidade}}. |
telefone,nome,cidade,vencimento
5583999991234,Ana Souza,João Pessoa,10/12
(83) 98888-7777,Bruno Lima,Campina Grande,15/12
Você pode escolher etiquetas para aplicar a todos os contatos do arquivo. No fim, o TWMULT mostra quantos contatos foram criados, atualizados e quantas linhas eram inválidas (sem telefone válido).
Use nomes de coluna simples, sem acentos nem espaços (data_compra em vez de “Data da compra”), para escrever as variáveis com facilidade.
Etiquetas
Etiquetas agrupam contatos: “cliente”, “vip”, “lead-instagram”. Com elas você filtra a lista e escolhe o público das campanhas. Crie etiquetas com nome e cor, aplique na importação ou selecione vários contatos e use as ações em massa para etiquetar, remover etiqueta ou excluir.
Pela API, as etiquetas são enviadas pelo nome e as que não existem são criadas na hora.
Opt-out: SAIR, PARAR e VOLTAR
Quando um contato responde apenas SAIR ou PARAR (também valem stop, descadastrar e cancelar inscrição, sem diferença entre maiúsculas e minúsculas), o TWMULT:
- marca o contato como opt-out;
- encerra a conversa e envia uma confirmação, avisando que ele pode responder VOLTAR se mudar de ideia;
- tira o contato de todas as campanhas, inclusive das que já estão em andamento.
Se o contato responder VOLTAR (ou reativar), o opt-out é removido. Você também pode marcar ou desmarcar o opt-out manualmente no cadastro do contato.
O opt-out vale para mensagens automáticas e campanhas. A equipe ainda consegue responder o contato pela caixa de entrada se ele voltar a escrever.