​
Aperçu

Les liens profonds permettent aux utilisateurs de votre application mobile de passer des appels et d’envoyer des SMS via OpenPhone sans quitter votre application. Créez des expériences de communication fluides en intégrant les schémas d’URL d’OpenPhone dans votre application mobile.
Les liens profonds sont disponibles uniquement pour les applications mobiles. Les applications web et de bureau ne sont pas prises en charge.

​
Cas d’usage

Les liens profonds sont idéaux pour :
  • Les applications de service client avec fonctionnalité d’appel
  • Les applications métier nécessitant une communication directe
  • Les applications mobiles de CRM
  • Les applications de service 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

Obligatoires :
  • number : Chaîne de numéro de téléphone encodée en URL
Facultatifs :
  • from : Numéro OpenPhone encodé en URL à utiliser comme identifiant de l’appelant
  • action : Définir sur call pour la numérotation automatique
Si from n’est pas spécifié, le numéro OpenPhone actuellement sélectionné est utilisé. Pour les appels automatiques avec plusieurs numéros, spécifiez from pour éviter les invites de sélection de numéro.

​
Exemples

Numérotation 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 : Numéro de téléphone sous forme de chaîne encodée en URL
  • from : Numéro OpenPhone encodé en URL depuis lequel envoyer
  • selectedAsFallback : Utiliser le numéro actuel lorsque from n’est pas défini (par défaut : false)
  • text : Contenu du message encodé en URL
  • attachments : URL séparées par des virgules pointant vers des fichiers avec les extensions appropriées (.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

L’appel 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
Appel de groupe : 
openphone://dial?number=4107934326,9801235640&action=call

​
Limitations et exigences

Limites de taille de groupe :
  • Maximum 9 numéros de téléphone par groupe (l’utilisateur est le 10e participant)
  • Pour l’appel 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 en URL : @9997934326 devient %409997934326
L’appel de groupe nécessite le paramètre action=call lorsque plusieurs numéros sont fournis.

​
Expérience utilisateur

​
Comportement de l’application

Lorsque les utilisateurs appuient sur des liens profonds :
  • Application installée : OpenPhone se lance avec le composeur d’appel ou de messages pré-rempli
  • Application 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 d’appel

​
Conseils d’implémentation

Bonnes 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 repli lorsque OpenPhone n’est pas installé
  • Prendre en compte l’expérience utilisateur pour les invites de sélection de numéro
Exemples d’encodage URL :
  • Espace : %20
  • Signe plus : %2B
  • Symbole arobase : %40
  • Virgule : %2C