Cree llamadas, mensajería e inteligencia artificial en la API de Acepeak.
Puntos finales REST, webhooks en tiempo real y SDK de primera clase. Autentique la API con un token de acceso al portador y envíe su 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
Obtener un token de acceso
Inicie sesión en el panel de Acepeak, abra Desarrolladores → Tokens y cree un nuevo token al portador. Los tokens tienen un alcance por entorno (sandbox o en vivo) y se pueden rotar desde el panel en cualquier momento.
Atención: mantenga los tokens activos en el lado del servidor. Todo lo que toque un navegador debe pasar por su backend.
- 02paso
Autenticar
Cada solicitud utiliza autenticación de token de portador en el encabezado de Autorización.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
- 03paso
Envía tu primera solicitud
Realice una llamada, envíe un SMS o enumere sus números; elija el que se ajuste a su caso de uso. Debería ver una lista JSON de sus números de teléfono. Desde allí, puede realizar llamadas, enviar SMS, configurar webhooks y comenzar a crear.
curl https://endpoints.acepeak.com/v1/numbers \ -H "Authorization: Bearer $ACEPEAK_TOKEN"
Todas las capacidades de la plataforma. se expone a través de REST.
llamadas de voz
Realice llamadas salientes, controle llamadas entrantes, transfiera, realice conferencias, grabe y transcriba. Flujos de URL de respuesta programables, captura DTMF durante la llamada, transmisión en tiempo real.
/v1/calls/v1/conferences/v1/recordingsMensajería (SMS y MMS)
Envíe y reciba números 10DLC, gratuitos y de código corto de EE. UU. Bidireccional, recibos de entrega, cumplimiento de exclusión voluntaria, mensajes largos concatenados.
/v1/messages/v1/messages/inboundNúmeros de teléfono
Busque, compre, transfiera y libere. DID locales de EE. UU., gratuitos e internacionales en más de 60 países.
/v1/numbers/v1/numbers/available/v1/numbers/port-ordersUsuarios y equipos
Aprovisione usuarios, asigne roles, administre equipos, configure SSO. SCIM 2.0 para la gestión automatizada del ciclo de vida con su IdP.
/v1/users/v1/teams/v1/ssoGanchos web
Entrega en tiempo real de llamadas, mensajes y eventos de grabación a su terminal. HMAC-SHA256 firmado, reintentado con retroceso exponencial durante 24 h.
/v1/webhooks/v1/webhooks/{id}/eventsSuperficies de IA
Active la recepcionista de IA, obtenga transcripciones, obtenga puntuaciones de sentimiento por llamada o por chat.
/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentimentManeras para autenticar.
Autenticación de token de acceso
Recomendado para servicios backend. Token de portador enviado en cada solicitud. Los tokens tienen un alcance por entorno, se pueden rotar desde el panel y están vinculados a una función específica para un acceso con privilegios mínimos.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
OAuth 2.0
Para aplicaciones de socios e integraciones de mercado. Otorgamiento del Código de Autorización con PKCE. Úselo cuando su aplicación actúe en nombre de un cliente en lugar de su propia cuenta.
- Código de autorización + PKCE
- Actualizar tokens · Valor predeterminado de 30 días
- Alcance por cliente
Predecible, documentado, y nunca en silencio.
Límites de tarifas
Por defecto: 100 r/s por token de acceso. Estalla hasta 200 r/s para ventanas cortas. Cuando se excede, la plataforma devuelve 429 con un encabezado Retry-After.
Idempotencia
Las solicitudes mutantes admiten una Idempotency-Key encabezamiento. Úselo en 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 no válido o faltante403ProhibidoEl token no tiene alcance.404ExtraviadoRecurso no encontrado409ConflictoIdempotencia o desajuste de estado429Tarifa limitadaReducir la velocidad: se proporciona Reintentar después5xxDel lado del servidorReintentar con retroceso exponencial
Eventos en tiempo real entregado a su punto final.
Suscríbase a un punto final HTTPS para llamar, enviar mensajes y grabar eventos. Los webhooks están firmados con HMAC-SHA256: verifique la firma antes de procesarlos. Las entregas fallidas se reintentan con un retraso exponencial de hasta 24 horas. Puede 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, mapeado en espejo para REST.
URL estables. Actualizaciones predecibles.
Las versiones de la interfaz están fijadas en la URL. (/v1/). Los cambios importantes se incluyen detrás de una nueva versión principal. Las adiciones permanentes llegan a la misma versión con una nota de versión en el registro de cambios del desarrollador.
Las funciones permanecen activas durante 12 meses después de un aviso de desuso. Enviamos un correo electrónico a cada equipo con un token de acceso activo a 90, 30 y 7 días antes del corte: no hay sorpresas en la producción.
¿Listo para empezar a construir?
Preguntas, respondió.
Es una interfaz REST más webhooks firmados que exponen llamadas de voz, SMS/MMS, números de teléfono, usuarios y superficies de IA. Autentíquese con un token de acceso al portador, acceda a los puntos finales documentados y realice el envío en minutos.
Construir sobre la API, enviar el mismo día.
Soporte 24 horas al día, 7 días a la semana incluido. Números transferidos desde cualquier operador en todo el mundo.