Descripción general

La API de OpenPhone permite a los desarrolladores integrar las capacidades de comunicación de OpenPhone directamente en sus aplicaciones y flujos de trabajo. Envía mensajes, administra contactos y automatiza procesos de comunicación de manera programática.
El acceso a la API requiere una suscripción activa de 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 espacio de trabajo
  • Registro completado con operadores de EE.UU. para envío de mensajes a números estadounidenses
  • Créditos prepagados para mensajería por API

Documentación de la API

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

Capacidades de la API

Funcionalidad principal

Endpoints de API disponibles:
  • Enviar mensajes: Enviar SMS/MMS de forma programática
  • Gestionar contactos: Crear, actualizar y organizar contactos
  • Obtener conversaciones: Acceder al historial de mensajes e hilos de conversación
  • Integración de webhooks: Recibir notificaciones de eventos en tiempo real

Funciones de mensajería

Tipos de mensajes compatibles:
  • Mensajes de texto SMS a números de Estados Unidos, Canadá e internacionales
  • Mensajes MMS con archivos multimedia adjuntos
  • Funciones de mensajería grupal
  • Seguimiento del estado de mensajes y confirmación de entrega

Precios y facturación

Costos de mensajes de API

Sistema de créditos prepagados:
  • Mensajes de EE.UU. y Canadá: $0.01 por segmento de mensaje
  • Mensajes internacionales: $0.01 por segmento + tarifas internacionales
  • Créditos prepagados requeridos: Compra a través de la configuración de facturación
  • Sin tarifas mensuales de API: Paga solo por los mensajes enviados
La mensajería de API requiere créditos prepagados. Los mensajes fallarán si no hay créditos suficientes disponibles.

Segmentos de mensaje

Cómo funcionan los segmentos de mensaje:
  • SMS estándar: 160 caracteres = 1 segmento
  • SMS Unicode/emoji: 70 caracteres = 1 segmento
  • Los mensajes más largos se dividen automáticamente en múltiples segmentos
  • Los mensajes MMS cuentan como un solo segmento sin importar el 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
  • Regenera las claves si se han visto comprometidas
  • Utiliza variables de entorno para almacenar las claves de forma segura

Límites de velocidad

Límites de uso de la API:
  • Diseñados para prevenir el abuso y garantizar la confiabilidad
  • 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 con soporte para obtener límites más altos si es necesario

Ejemplos de integración

Casos de uso comunes

Implementaciones populares de la API:
  • Notificaciones al cliente: 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 comunicaciones

Recursos para desarrolladores

Cómo empezar rápidamente:
  • Explorador interactivo de la API en la documentación
  • Ejemplos de código en múltiples lenguajes de programación
  • Colección de Postman para realizar pruebas
  • Ejemplos y plantillas de la comunidad

Integraciones relacionadas

Explora integraciones preconfiguradas que complementan el uso de la API:
Consulta todas las integraciones disponibles en nuestra página de integraciones, incluyendo Salesforce, HubSpot y Gong.