Crea llamadas, mensajería y AI sobre la api de Acepeak.
Endpoints REST, webhooks en tiempo real y SDKs de primera clase. Autentica la api con un token de acceso bearer y envía tu primera solicitud en menos de cinco minutos.
# Place a call from a US number
curl -X POST https://endpoints.acepeak.com/v1/calls \
-H "Authorization: Bearer $ACEPEAK_TOKEN" \
-H "Content-Type: application/json" \
-d '{"from":"+18005551212",
"to":"+14155551212",
"answer_url":"https://your.app/answer"}'Inicio rápido.
- 01paso
Obtén un token de acceso
Inicia sesión en el panel de Acepeak, abre Developers → Tokens y crea un nuevo token bearer. Los tokens tienen alcance por entorno (sandbox o live) y son rotables desde el panel en cualquier momento.
Atención — mantén los tokens live del lado del servidor. Todo lo que toque un navegador debe pasar por tu backend.
- 02paso
Autentícate
Cada solicitud usa autenticación por token bearer en la cabecera Authorization.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
- 03paso
Envía tu primera solicitud
Realiza una llamada, envía un SMS o lista tus números — elige lo que se ajuste a tu caso de uso. Deberías ver una lista JSON de tus números de teléfono. A partir de ahí, puedes realizar llamadas, enviar SMS, configurar webhooks y empezar a construir.
curl https://endpoints.acepeak.com/v1/numbers \ -H "Authorization: Bearer $ACEPEAK_TOKEN"
Cada capacidad de la plataforma se expone mediante REST.
Llamadas de voz
Realiza llamadas salientes, controla llamadas entrantes, transfiere, haz conferencias, graba y transcribe. Flujos de answer-URL programables, captura de DTMF en llamada y streaming en tiempo real.
/v1/calls/v1/conferences/v1/recordingsMensajería (SMS y MMS)
Envía y recibe en números 10DLC de EE. UU., gratuitos y de código corto. Bidireccional, acuses de entrega, cumplimiento de exclusión y mensajes largos concatenados.
/v1/messages/v1/messages/inboundNúmeros de teléfono
Busca, compra, porta y libera. DIDs locales de EE. UU., gratuitos e internacionales en 60+ países.
/v1/numbers/v1/numbers/available/v1/numbers/port-ordersUsuarios y equipos
Aprovisiona usuarios, asigna roles, gestiona equipos y configura SSO. SCIM 2.0 para la gestión automatizada del ciclo de vida con tu IdP.
/v1/users/v1/teams/v1/ssoWebhooks
Entrega en tiempo real de eventos de llamada, mensaje y grabación a tu endpoint. Firmado con HMAC-SHA256, reintentado con retroceso exponencial durante 24h.
/v1/webhooks/v1/webhooks/{id}/eventsInterfaces de AI
Activa el AI Receptionist, extrae transcripciones y obtén puntuaciones de sentimiento por llamada o por chat.
/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentimentFormas de autenticarte.
Autenticación por token de acceso
Recomendado para servicios de backend. Token bearer enviado en cada solicitud. Los tokens tienen alcance por entorno, son rotables desde el panel y están vinculados a un rol específico para un acceso de mínimo privilegio.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
OAuth 2.0
Para apps de socios e integraciones de marketplace. Concesión de Authorization Code con PKCE. Úsalo cuando tu app actúe en nombre de un cliente en lugar de tu propia cuenta.
- Authorization Code + PKCE
- Refresh tokens · 30 días por defecto
- Alcance por cliente
Predecibles, documentados y nunca silenciosos.
Límites de tasa
Por defecto: 100 r/s por token de acceso. Ráfagas de hasta 200 r/s en ventanas cortas. Al superarse, la plataforma devuelve 429 con una cabecera Retry-After.
Idempotencia
Las solicitudes que modifican datos admiten una cabecera Idempotency-Key . Úsala en las solicitudes POST, PUT y DELETE para que los reintentos no cobren ni envíen dos veces.
Códigos de error
400Solicitud incorrectaLa validación falló401No autorizadoToken de acceso inválido o ausente403ProhibidoEl token no tiene el alcance necesario404No encontradoRecurso no encontrado409ConflictoDiscrepancia de idempotencia o de estado429Límite de tasa alcanzadoReduce el ritmo — se proporciona Retry-After5xxDel lado del servidorReintenta con retroceso exponencial
Eventos en tiempo real entregados a tu endpoint.
Suscribe un endpoint HTTPS a eventos de llamada, mensaje y grabación. Los webhooks están firmados con HMAC-SHA256 — verifica la firma antes de procesarlos. Las entregas fallidas se reintentan con retroceso exponencial durante un máximo de 24 horas. Puedes reproducir cualquier evento desde el panel.
{
"id": "evt_01HW3...",
"type": "call.completed",
"created_at": "2026-04-30T10:42:00Z",
"data": {
"call_id": "CA_01HW...",
"duration_sec": 184
}
}Bibliotecas de primera clase, mapeadas en espejo a REST.
URLs estables. Actualizaciones predecibles.
Las versiones de la interfaz se fijan en la URL (/v1/). Los cambios incompatibles se entregan tras una nueva versión mayor. Las adiciones compatibles llegan en la misma versión con una nota de versión en el changelog para desarrolladores.
Las funciones permanecen activas durante 12 meses tras un aviso de obsolescencia. Enviamos un correo a cada equipo con un token de acceso activo 90, 30 y 7 días antes de la fecha límite — sin sorpresas en producción.
¿Listo para empezar a construir?
Preguntas, respondidas.
Es una interfaz REST más webhooks firmados que expone llamadas de voz, SMS / MMS, números de teléfono, usuarios e interfaces de AI. Autentícate con un token de acceso bearer, accede a los endpoints documentados y publica en minutos.
Construye sobre la api, publica el mismo día.
Soporte 24/7 incluido. Portabilidad de números desde cualquier operador del mundo.