Pular para o conteúdo principal

​
Conceito

Contacts são os registros de clientes no CRM integrado da Timely.ai. Toda conversa que chega por qualquer canal (WhatsApp, Instagram, Telegram, widget) é automaticamente associada a um contato — criado com base no identificador do canal (número de telefone, IGSID, chat_id do Telegram) ou vinculado a um contato existente por email ou telefone. Você também pode criar e atualizar contatos via API para sincronizar com seu CRM externo, plataformas de e-commerce, sistemas de cobrança ou qualquer outra fonte de dados. Os contatos suportam campos personalizados via Custom Fields, o que permite adaptar o CRM às necessidades específicas do seu negócio.

​
Campos principais

​
Deduplicação automática

A Timely tenta evitar contatos duplicados ao criar automaticamente durante uma conversa. A deduplicação usa a seguinte prioridade:
  1. Identificador do canal (phone para WhatsApp, IGSID para Instagram)
  2. Email (se disponível)
  3. Telefone normalizado (E.164)
Ao criar via API, se já existir um contato com o mesmo phone ou email, a Timely retorna o contato existente em vez de criar um duplicado.

​
Endpoints disponíveis

Consulte a barra lateral à esquerda para a lista completa de endpoints deste grupo. Cada endpoint tem sua própria página com schema de request/response, exemplos em cURL/JS/Python e playground interativo.

​
Próximos passos

Primeira requisição

Se você ainda não fez sua primeira chamada, comece por aqui.