Descripción general

El deep linking permite que los usuarios de tu app móvil llamen y envíen mensajes a través de OpenPhone sin salir de tu app. Crea experiencias de comunicación fluidas integrando los esquemas de URL de OpenPhone en tu aplicación móvil.
El deep linking está disponible solo para apps móviles. Las aplicaciones web y de escritorio no son compatibles.

Casos de uso

El deep linking es ideal para:
  • Aplicaciones de atención al cliente con función de llamadas
  • Aplicaciones empresariales que requieren comunicación directa
  • Aplicaciones móviles de CRM
  • Aplicaciones de servicio de campo y de entregas
  • Cualquier aplicación móvil con funciones de comunicación

Marcación de números de teléfono

Formato del esquema de URL

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

Parámetros

Obligatorio:
  • number: Cadena con el número de teléfono codificada en URL
Opcionales:
  • from: Número de OpenPhone codificado en URL para usar como ID de llamada (caller ID)
  • action: Defínalo como call para realizar la marcación automática
Si no se especifica from, se usa el número de OpenPhone seleccionado actualmente. Para realizar llamadas automáticas con varios números, especifique from para evitar los avisos de selección de número.

Ejemplos

Marcación básica:
openphone://dial?number=4107934326
openphone://dial?number=%2B14107934326
Llamada automática:
openphone://dial?number=4107934326&from=3239991234&action=call

Redacción de mensajes

Formato del esquema de URL

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

Parámetros

Todos los parámetros son opcionales:
  • number: Cadena del número de teléfono codificada en URL
  • from: Número de OpenPhone codificado en URL desde el cual enviar
  • selectedAsFallback: Usar el número actual cuando from no esté definido (valor predeterminado: false)
  • text: Cuerpo del mensaje codificado en URL
  • attachments: URLs separadas por comas a archivos con las extensiones adecuadas (.jpg, .pdf, etc.)

Ejemplos

Mensaje simple:
openphone://message?text=Hello,%20buddy
Mensaje con archivos adjuntos:
openphone://message?number=4107934326&text=Hello,%20buddy&attachments=https%3A%2F%2Fexample.com%2Ffile.pdf,https%3A%2F%2Fexample.com%2Fimage.png

Comunicaciones grupales

Múltiples destinatarios

Tanto las llamadas como los mensajes admiten múltiples destinatarios proporcionando números de teléfono separados por comas: Mensajería grupal:
openphone://message?number=4107934326,9801235640&text=Hello
Llamadas grupales:
openphone://dial?number=4107934326,9801235640&action=call

Limitaciones y requisitos

Límites del tamaño del grupo:
  • Máximo 9 números de teléfono por grupo (el usuario es el décimo participante)
  • Para la llamada grupal, se requiere el parámetro action=call
Números directos:
  • Los números directos del usuario comienzan con el símbolo @
  • Deben estar codificados en URL: @9997934326 se convierte en %409997934326
Las llamadas grupales requieren el parámetro action=call cuando se proporcionan varios números.

Experiencia del usuario

Comportamiento de la app

Cuando los usuarios abren deep links:
  • App instalada: OpenPhone se abre con el marcador o el redactor de mensajes rellenado previamente
  • App no instalada: Se redirige a App Store (iOS) o Google Play Store (Android)
  • Múltiples números disponibles: Es posible que se le pida al usuario seleccionar el número desde el que llamar

Consejos de implementación

Mejores prácticas:
  • Codifica siempre en URL los números de teléfono y el contenido del mensaje
  • Prueba los deep links en dispositivos iOS y Android
  • Gestiona escenarios de contingencia cuando OpenPhone no esté instalada
  • Ten en cuenta la experiencia del usuario en los avisos para seleccionar número
Ejemplos de codificación en URL:
  • Espacio: %20
  • Signo más: %2B
  • Arroba: %40
  • Coma: %2C