Descripción general

El deep linking permite que los usuarios de tu app móvil llamen y envíen mensajes de texto a través de Quo sin salir de tu app. Crea experiencias de comunicación fluidas integrando los esquemas de URL de Quo 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:
  • Apps de atención al cliente con función de llamadas
  • Apps empresariales que requieren comunicación directa
  • Apps móviles de CRM
  • Apps de servicio en campo y entregas
  • Cualquier app móvil con funciones de comunicación

Cómo marcar números de teléfono

Formato del esquema de URL

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

Parámetros

Obligatorios:
  • number: cadena de número de teléfono codificada en URL
Opcionales:
  • from: número de Quo codificado en URL para usar como identificador de llamada
  • action: establézcalo en call para marcar automáticamente
Si no se especifica from, se utilizará el número de Quo seleccionado actualmente. Para realizar llamadas automáticas con varios números, especifique from para evitar el aviso de selección de número.

Ejemplos

Llamada básica:
openphone://dial?number=4107934326
openphone://dial?number=%2B14107934326
Llamadas automáticas:
openphone://dial?number=4107934326&from=3239991234&action=call

Redactar 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 de número de teléfono codificada en URL
  • from: número de Quo codificado en URL desde el cual enviar
  • selectedAsFallback: usar el número actual cuando no se establezca from (valor predeterminado: false)
  • text: cuerpo del mensaje codificado en URL
  • attachments: URL separadas por comas de archivos con extensiones válidas (.jpg, .pdf, etc.)

Ejemplos

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

Comunicaciones en grupo

Varios destinatarios

Tanto las llamadas como los mensajes admiten varios destinatarios si se proporcionan números de teléfono separados por comas: Mensajería grupal:
openphone://message?number=4107934326,9801235640&text=Hola
Llamadas en grupo:
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 participante número 10)
  • Para la marcación en grupo, se requiere el parámetro action=call
Números directos:
  • Los números directos de usuario comienzan con el símbolo @
  • Deben estar codificados para URL: @9997934326 se convierte en %409997934326
La marcación en grupo requiere el parámetro action=call cuando se proporcionan varios números.

Experiencia de usuario

Comportamiento de la app

Cuando los usuarios abren enlaces profundos:
  • App instalada: Quo se abre con el marcador o el redactor de mensajes ya completado
  • App no instalada: Redirige a la App Store (iOS) o a Google Play Store (Android)
  • Múltiples números disponibles: Es posible que se 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 de los mensajes
  • Prueba los enlaces profundos (deep links) en dispositivos iOS y Android
  • Gestiona escenarios de respaldo cuando Quo no esté instalado
  • Ten en cuenta la experiencia del usuario en los avisos para seleccionar un número
Ejemplos de codificación de URL:
  • Espacio: %20
  • Signo más: %2B
  • Símbolo de arroba: %40
  • Coma: %2C