Créer un agent

Variables et données de contact

Un agent sait à qui il parle. Avant chaque appel, CallShift associe le numéro à un contact du CRM et transmet à l'agent les données de ce contact.

Les champs du contact dans le prompt

Un contact comporte les champs salutation, firstName, lastName, email, un texte information et un objet libre metadata. Les prompts y accèdent par des variables, et {{contact.metadata.<key>}} lit n'importe quelle clé des métadonnées, y compris les chemins imbriqués avec des points.

JSON

{
  "firstName": "Ada",
  "phoneNumber": "+33612345678",
  "metadata": { "plan": "pro", "renewal": { "date": "2026-11-15" } }
}

Prompt

The customer is on the {{contact.metadata.plan}} plan,
which renews on {{contact.metadata.renewal.date}}.

Renseignez metadata ou information : quand metadata est renseigné, il prime. Les métadonnées du contact figurent aussi dans le webhook de fin d'appel.

Les fautes de frappe passent inaperçues

Une variable qui ne renvoie rien devient une chaîne vide, sans erreur. Vérifiez chaque nouvelle variable sur un appel de test.

Date et heure

CallShift ajoute à chaque prompt la date du jour, celle du lendemain et l'heure actuelle, dans le fuseau horaire du compte (réglages du compte, Europe/Paris par défaut). Inutile de les mettre dans vos prompts. {{now}}, {{today}}, {{tomorrow}} et {{timezone}} sont disponibles si vous en avez besoin dans une phrase.

Appels entrants

L'appelant est identifié par son numéro, exactement comme dans une campagne, et le prompt doit faire référence à contact.* pour que la recherche ait lieu. Pour donner à l'agent des données à jour avant qu'une personne appelle, mettez le contact à jour au préalable avec PATCH/v1/contact/{contactId} : son id arrive dans le webhook de fin d'appel sous contact.id.