Pré-remplissage des contacts : expéditeur et destinataire
Les coordonnées de l’expéditeur et du destinataire que vous fournissez à la création d’un conteneur ne servent pas qu’à être stockées — elles déterminent un canal de remise et pré-remplissent chaque écran du parcours d’enregistrement qui, sinon, les demanderait.
Avant cette page
Cette page suppose que vous savez déjà ce que contient un conteneur et comment la remise est déclenchée. Lire la page Remise
Pré-remplissage sans formulaire
Lorsque votre intégration embarque directement le widget Recorder — sans formulaire qui le précède — le widget n’a aucune autre source pour un nom ou une adresse où remettre le message. Ce que vous avez transmis dans sender et recipient à la création est exactement ce que le parcours affiche et ce que la remise utilise ; vous n’aurez pas de seconde occasion de le collecter plus loin dans ce parcours.
Résolution du canal du destinataire
recipient.channel détermine où part le message, mais son comportement par défaut est facile à mal interpréter.
- Pour un destinataire qui n’a qu’un numéro de téléphone, il faut définir explicitement channel: "sms" — laisser channel vide avec seulement un téléphone ne bascule pas sur le SMS.
Format du téléphone
recipient.phone suit la norme E.164 : un signe plus en tête, un premier chiffre différent de zéro, et de huit à quinze chiffres au total.
^\+[1-9][0-9]{7,14}$Ordre de résolution des contacts
Un conteneur peut porter des coordonnées sous plusieurs formes à la fois — les champs typés, un champ de premier niveau obsolète et des alias libres. Lorsque plusieurs sont présentes, voici l’ordre qui détermine la valeur retenue.
| Ordre | Source |
|---|---|
| 1 | Champs typés sender et recipient |
| 2 | Champ email de premier niveau (obsolète) |
| 3 | Alias reconnus dans additionalData |
additionalData est conservé tel quel
additionalData est stocké exactement tel que vous l’envoyez — rien n’y est réécrit, même lorsque l’un de ses alias reconnus (email, senderEmail, les variantes du nom de l’expéditeur, receiverEmail, receiverPhone, messageNotified) sert à résoudre une coordonnée selon la règle ci-dessus.