# Contact Synchronization

When logging into TelegrApp you must have in mind that only those contacts that initiate a conversation with you, will be saved in Contacts using the *senderId* (a unique identifier for Telegram users):

<figure><img src="https://2324752097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5UVJXDp4vHmwHs2Et3eR%2Fuploads%2F8WVFs0BUG9Ep4V5f81BX%2FCaptura%20de%20pantalla%202025-12-15%20165539.png?alt=media&#x26;token=91077b56-108b-46fa-942e-419728d41252" alt=""><figcaption><p>SenderId Custom Field in the Contact information</p></figcaption></figure>

If you had already contacts saved in the CRM, please note these will **not** sync as there is no index to stablish the connection with. We strongly recommend reading the Privacy Overview section in advance, to clearly understand how the contact management works

{% content-ref url="guide" %}
[guide](https://telegrapp.gitbook.io/telegrapp-documentation/features/general/guide)
{% endcontent-ref %}

and also continue reading to find some use-case examples.

{% hint style="info" %}
e.g. If you had a contact called "John Perk" in the CRM and simultaneously were having a conversation with him through Telegram PRIOR TO logging in **TelegrApp,** do NOT expect to have the contact merged.
{% endhint %}

{% hint style="warning" %}
Only after you have logged in into TelegrApp, clients that send you a message through telegram will be saved and synced (using the *senderId* index variable) in your CRM contacts list.
{% endhint %}

In case you want to sync your CRM contacts with the ones in your Telegram, a **merge or import** will be necessary. This **merge/import** can be done in two different ways:

* By hand: including the *senderId* in the specific contact's custom field will merge the contact you had prior to the TelegrApp login, with the telegram's conversation you had with the client.

<figure><img src="https://2324752097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5UVJXDp4vHmwHs2Et3eR%2Fuploads%2FdZHuz0jb5ee2FLTCuo9L%2FCaptura%20de%20pantalla%202025-12-15%20170220.png?alt=media&#x26;token=b3859392-3beb-46f9-883b-55b012667010" alt=""><figcaption></figcaption></figure>

* By bulk: the CRM allows a bulk import merge option (in a specific format) of contacts, where we can include variables like

  * Name & Surname (optional values)
  * Phone Number (optional / not visible for privacy)
  * Username (optional)
  * *senderId* (**imposed** by telegram)

  that the CRM will **compare** with the current contact database you have, assigning as an index element (name, phone, etc) one of the former variables.&#x20;

{% hint style="info" %}
e.g. If your contact "John Perk" with a defined phone number "+34654879154" is already present at the CRM, and you also have that contact with **the same details** in your Telegram account (in your phone), we will provide a list with your Telegram contacts (formatted), and their phone numbers (if present) together with the necessary s*enderId* index variable.&#x20;

This way when doing the batch import, the import tool will compare the contact details information, and link those with the same details, automatically adding the s*enderId* variable.
{% endhint %}

{% hint style="warning" %}
It is paramount that the contact details in your CRM and your phone are the same, e.g. "John Perk" in the CRM shall also be "John Perk" in your phone.
{% endhint %}

<figure><img src="https://2324752097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5UVJXDp4vHmwHs2Et3eR%2Fuploads%2FvSPC8DF6QgAlgWhwAZfP%2FCaptura%20de%20pantalla%202025-12-15%20170339.png?alt=media&#x26;token=961bd6c3-dbab-4cd9-8e85-4c526a7ca104" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2324752097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5UVJXDp4vHmwHs2Et3eR%2Fuploads%2FptgrrWjQbmYUMNmao8L7%2FCaptura%20de%20pantalla%202025-12-15%20170436.png?alt=media&#x26;token=bb4bbcee-91f5-4c3e-a1dc-56aa7af6bae6" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://2324752097-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5UVJXDp4vHmwHs2Et3eR%2Fuploads%2F3HFLRWPQFd0iNN4ALxD9%2FCaptura%20de%20pantalla%202025-12-15%20170501.png?alt=media&#x26;token=276d4db0-0898-49c5-8c64-170a23858e73" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="danger" %}
WARNING: this is **critical** as the former variables except from the *senderId* are optional, and may not be the same ones you saved in your contact database. In case you are not fully aware of these merge details, we do not recommend making a bulk merge.
{% endhint %}

If you want to continue with the **bulk import**, we will provide a formatted document with all the available info we have to ease your synchronization efforts. This will be available in the TelegrApp Connect page, in the form of a button called "Retrieve Telegram Contact Info".

{% hint style="danger" %}
WARNING: we are not responsible for losing, deleting or modifying accidentaly any contact. The merge action is solely and purely responsibility of the user.
{% endhint %}