Aperçu

Les liens profonds permettent à vos utilisateurs sur mobile d’appeler et d’envoyer des messages avec OpenPhone sans quitter votre application. Offrez une expérience de communication fluide en intégrant les schémas d’URL d’OpenPhone à votre application mobile.
Les liens profonds sont offerts uniquement pour les applications mobiles. Les applications web et de bureau ne sont pas prises en charge.

Cas d’utilisation

Les liens profonds sont idéaux pour :
  • Applications de service à la clientèle avec fonction d’appel
  • Applications professionnelles nécessitant une communication directe
  • Applications mobiles de CRM
  • Applications de service sur le terrain et de livraison
  • Toute application mobile avec des fonctionnalités de communication

Composer des numéros de téléphone

Format du schéma d’URL

openphone://dial?number=<number>&from=<from>&action=call

Paramètres

Obligatoire :
  • number : Chaîne de caractères représentant un numéro de téléphone, encodée en URL
Optionnel :
  • from : Numéro OpenPhone encodé en URL à utiliser comme identifiant de l’appelant
  • action : Définir sur call pour lancer automatiquement l’appel
Si from n’est pas indiqué, le numéro OpenPhone actuellement sélectionné est utilisé. Pour l’appel automatique lorsque plusieurs numéros sont disponibles, précisez from afin d’éviter l’invite de sélection de numéro.

Exemples

Composition de base :
openphone://dial?number=4107934326
openphone://dial?number=%2B14107934326
Appel automatique :
openphone://dial?number=4107934326&from=3239991234&action=call

Rédaction de messages

Format du schéma d’URL

openphone://message?number=<number>&from=<from>&text=<text>&attachments=<url1>,<url2>

Paramètres

Tous les paramètres sont facultatifs :
  • number: Chaîne de numéro de téléphone encodée en URL
  • from: Numéro OpenPhone encodé en URL à utiliser comme expéditeur
  • selectedAsFallback: Utiliser le numéro actuel si from n’est pas défini (valeur par défaut : false)
  • text: Corps du message encodé en URL
  • attachments: URL séparées par des virgules pointant vers des fichiers avec les bonnes extensions (.jpg, .pdf, etc.)

Exemples

Message simple :
openphone://message?text=Hello,%20buddy
Message avec pièces jointes :
openphone://message?number=4107934326&text=Hello,%20buddy&attachments=https%3A%2F%2Fexample.com%2Ffile.pdf,https%3A%2F%2Fexample.com%2Fimage.png

Communications de groupe

Destinataires multiples

La composition et la messagerie prennent en charge plusieurs destinataires en fournissant des numéros de téléphone séparés par des virgules : Messagerie de groupe :
openphone://message?number=4107934326,9801235640&text=Hello
Appels de groupe :
openphone://dial?number=4107934326,9801235640&action=call

Limitations et exigences

Limites de taille du groupe :
  • Maximum de 9 numéros de téléphone par groupe (l’utilisateur est le 10e participant)
  • Pour la composition de groupe, le paramètre action=call est requis
Numéros directs :
  • Les numéros directs des utilisateurs commencent par le symbole @
  • Doivent être encodés dans l’URL : @9997934326 devient %409997934326
La composition de groupe nécessite le paramètre action=call lorsque plusieurs numéros sont fournis.

Expérience utilisateur

Comportement de l’app

Lorsque les utilisateurs touchent des liens profonds :
  • App installée : OpenPhone s’ouvre avec le numéroteur ou le rédacteur de message prérempli
  • App non installée : Redirige vers l’App Store (iOS) ou le Google Play Store (Android)
  • Plusieurs numéros disponibles : L’utilisateur peut être invité à sélectionner le numéro à utiliser pour l’appel

Conseils de mise en œuvre

Meilleures pratiques :
  • Toujours encoder en URL les numéros de téléphone et le contenu des messages
  • Tester les liens profonds sur les appareils iOS et Android
  • Gérer les scénarios de secours lorsque OpenPhone n’est pas installé
  • Tenir compte de l’expérience utilisateur pour les invites de sélection de numéro
Exemples d’encodage URL :
  • Espace : %20
  • Signe plus : %2B
  • Arobase : %40
  • Virgule : %2C