Introdução aos Contatos

Contatos

Os contatos representam as pessoas que interagem com sua empresa por meio dos canais de comunicação (WhatsApp, Instagram, etc.). Cada contato armazena informações de identificação, dados de contato e metadados personalizados.

Como funciona

Os contatos podem ser criados de duas formas:

Automaticamente: quando uma mensagem é recebida de um número que ainda não possui cadastro, o contato é criado automaticamente com o nome e número de telefone obtidos do canal
Manualmente: via API, utilizando o endpoint de criação de contatos

Principais campos

Campo	Descrição
`id`	Identificador único do contato
`name`	Nome do contato
`phone`	Número de telefone no formato internacional (ex: `5511999999999`)
`email`	Endereço de e-mail (opcional)
`tags`	Array de tags para categorização (ex: `["vip", "cliente"]`)
`metadata`	Objeto com campos personalizados (chave-valor livre)
`createdAt`	Data/hora de criação do contato
`updatedAt`	Data/hora da última atualização

Metadados personalizados

O campo metadata permite armazenar informações adicionais em formato chave-valor livre. Exemplos de uso:

{
  "metadata": {
    "empresa": "Acme Ltda",
    "cpf": "123.456.789-00",
    "plano": "premium",
    "dataAniversario": "1990-05-15"
  }
}

LGPD e exclusão de dados

A Ogmma API oferece suporte a exclusão de dados em conformidade com a LGPD (Lei Geral de Proteção de Dados). Ao excluir um contato:

Os dados pessoais do contato são anonimizados (soft-delete)
O histórico de mensagens é mantido, mas as informações do contato são substituídas por dados genéricos
A operação é irreversível

Boas práticas

Mantenha os nomes dos contatos atualizados para facilitar a identificação no atendimento
Utilize tags de forma consistente para facilitar a segmentação
Armazene dados adicionais relevantes no campo metadata
Ao excluir contatos, considere as implicações legais (LGPD) e mantenha registro da solicitação

Contatos​

Como funciona​

Principais campos​

Tags​

Metadados personalizados​

LGPD e exclusão de dados​

Boas práticas​