Référence API

Contacts

Chaque numéro ayant échangé avec l'une de vos sessions devient un contact rattaché à votre compte.

Lister les contacts

GET/contacts?limit=50

Paramètre	Type	Description
search	string	Recherche par nom ou numéro.
sessionId	string	Limiter aux contacts d'une session.
limit	number	1 à 100, 25 par défaut.

searchstring
Recherche par nom ou numéro.
sessionIdstring
Limiter aux contacts d'une session.
limitnumber
1 à 100, 25 par défaut.

json

{
  "data": [
    {
      "id": "cont_9d21",
      "phone": "2250700000000",
      "name": "Awa K.",
      "lastMessageAt": "2026-09-13T22:41:10Z",
      "unread": 2
    }
  ],
  "nextCursor": null
}

Lire un contact

GET/contacts/{contactId}

Renvoie la fiche du contact, la session associée et les dernières informations de conversation.

Mettre à jour un contact

PUT/contacts/{contactId}

Paramètre	Type	Description
name	string	Nom affiché dans votre espace.
email	string	Adresse e-mail, utile pour la création de commandes.
tags	string[]	Étiquettes libres, par exemple « prospect » ou « VIP ».
notes	string	Note interne, non visible du contact.

namestring
Nom affiché dans votre espace.
emailstring
Adresse e-mail, utile pour la création de commandes.
tagsstring[]
Étiquettes libres, par exemple « prospect » ou « VIP ».
notesstring
Note interne, non visible du contact.