Skip to main content

​
Concept

Contacts are customer records in the Timely.ai integrated CRM. Every conversation that arrives through any channel (WhatsApp, Instagram, Telegram, widget) is automatically associated with a contact — created based on the channel identifier (phone number, IGSID, Telegram chat_id) or linked to an existing contact by email or phone. You can also create and update contacts via API to sync with your external CRM, e-commerce platforms, billing systems, or any other data source. Contacts support custom fields via Custom Fields, which lets you adapt the CRM to your specific business needs.

​
Main Fields

​
Automatic Deduplication

Timely tries to avoid duplicate contacts when automatically creating one during a conversation. Deduplication uses the following priority:
  1. Channel identifier (phone for WhatsApp, IGSID for Instagram)
  2. Email (if available)
  3. Normalized phone number (E.164)
When creating via API, if a contact with the same phone or email already exists, Timely returns the existing contact instead of creating a duplicate.

​
Available Endpoints

See the left sidebar for the full list of endpoints in this group. Each endpoint has its own page with request/response schema, cURL/JS/Python examples, and an interactive playground.

​
Next Steps

Your first request

If you haven’t made your first call yet, start here.