Descripción general

La API de OpenPhone permite a los desarrolladores integrar directamente las funcionalidades de comunicación de OpenPhone en sus aplicaciones y flujos de trabajo. Envía mensajes, gestiona contactos y automatiza procesos de comunicación de forma programática.
El acceso a la API requiere una suscripción activa a OpenPhone y permisos de propietario o administrador para tu espacio de trabajo.

Primeros pasos con la API

Requisitos previos

Requisitos para acceder a la API:
  • Suscripción activa a OpenPhone (cualquier plan)
  • Rol de propietario o administrador en tu workspace
  • Registro con operadores de EE. UU. completado para enviar mensajes a números de EE. UU.
  • Créditos prepago para mensajería mediante la API

Documentación de la API

Accede a la documentación y recursos completos de la API: Disponible en nuestra documentación de la API:
  • Configuración y autenticación paso a paso
  • Referencia completa de endpoints
  • Ejemplos de código y SDKs
  • Límites de uso y buenas prácticas
  • Información sobre precios y facturación

Capacidades de la API

Funcionalidad principal

Endpoints de la API disponibles:
  • Enviar mensajes: Enviar SMS/MMS de forma programática
  • Administrar contactos: Crear, actualizar y organizar contactos
  • Obtener conversaciones: Acceder al historial y a los hilos de mensajes
  • Integración con Webhooks: Recibir notificaciones de eventos en tiempo real

Funciones de mensajería

Tipos de mensajes admitidos:
  • Mensajes de texto SMS a números de EE. UU., Canadá e internacionales
  • Mensajes MMS con archivos multimedia adjuntos
  • Mensajería grupal
  • Seguimiento del estado del mensaje y confirmación de entrega

Precios y facturación

Costos de mensajes de la API

Sistema de créditos prepagados:
  • Mensajes en EE. UU. y Canadá: $0.01 por segmento
  • Mensajes internacionales: $0.01 por segmento + tarifas internacionales
  • Créditos prepagados requeridos: Cómpralos desde la configuración de facturación
  • Sin tarifas mensuales por la API: Paga solo por los mensajes enviados
La mensajería mediante la API requiere créditos prepagados. Los mensajes no se enviarán si no hay créditos suficientes.

Segmentos de mensajes

Cómo funcionan los segmentos:
  • SMS estándar: 160 caracteres = 1 segmento
  • SMS con Unicode/emoji: 70 caracteres = 1 segmento
  • Los mensajes más largos se dividen automáticamente en varios segmentos
  • Los MMS cuentan como un solo segmento, independientemente del tamaño del contenido

Autenticación y seguridad

Claves de API

Autenticación segura:
  • Genera claves de API desde la configuración del espacio de trabajo
  • Las claves proporcionan acceso seguro a los datos de tu espacio de trabajo
  • Vuelve a generar las claves si se ven comprometidas
  • Usa variables de entorno para almacenar las claves de forma segura

Límites de uso

Límites de uso de la API:
  • Diseñados para prevenir el abuso y garantizar la fiabilidad
  • Los límites varían según el endpoint y el nivel de suscripción
  • Supervisa el uso a través de las respuestas de la API
  • Contacta al soporte si necesitas límites más altos

Ejemplos de integraciones

Casos de uso comunes

Implementaciones populares de la API:
  • Notificaciones a clientes: Actualizaciones de pedidos, recordatorios de citas
  • Automatización de marketing: Campañas promocionales, secuencias de seguimiento
  • Flujos de trabajo de soporte: Notificaciones de tickets, actualizaciones de estado
  • Integración con CRM: Sincronización de contactos e historial de comunicación

Recursos de desarrollo

Para empezar rápidamente:
  • Explorador de API interactivo en la documentación
  • Ejemplos de código en varios lenguajes de programación
  • Colección de Postman para pruebas
  • Ejemplos y plantillas de la comunidad
Explora las integraciones listas para usar que complementan el uso de la API:
Consulta todas las integraciones disponibles en nuestra página de integraciones, incluidas Salesforce, HubSpot y Gong.