👥 Contatos
Contatos sao os registros de clientes no PulseHub. Cada conversa esta vinculada a um contato, e cada mensagem de entrada corresponde a um contato existente ou cria um novo.
Campos do Contato
| Campo | Descricao |
|---|---|
name | Nome de exibicao — extraido dos dados do provedor ou inserido manualmente |
email | Endereco de email — usado para corresponder remetentes de email |
phone | Numero de telefone — usado para corresponder remetentes WhatsApp e SMS |
tags | Array JSON de strings de tags para segmentacao |
notes | Campo de texto livre para notas do agente |
external_ids | Objeto JSON mapeando tipos de canal para IDs especificos do provedor |
Correspondencia de Contatos (Deduplicacao Automatica)
Quando uma nova mensagem de entrada chega:
- Se sender_phone estiver presente: corresponder por
contacts.phone - Senao, se sender_email estiver presente: corresponder por
contacts.email - Senao: corresponder por caminho JSON
external_ids - Se nao houver correspondencia: criar um novo contato
Quando uma correspondencia e encontrada, o PulseHub atualiza o campo external_ids para unificar o cliente entre canais.
Tags
- Tags de contato descrevem a pessoa:
[vip, enterprise, newsletter] - Tags de conversa descrevem o problema:
[urgent, billing, bug-report]
Ambas sao armazenadas como arrays JSON.
Referencia de IDs Externos
| Chave | Origem |
|---|---|
whatsapp | Numero de telefone do remetente |
telegram_chat_id | Telegram chat.id |
viber | Viber sender.id |
facebook | Facebook PSID |
instagram | Instagram PSID |
sms | Numero de telefone do remetente |