Crie chamadas, mensagens e IA na api da Acepeak.
Endpoints REST, webhooks em tempo real e SDKs de primeira classe. Autentique a api com um bearer access token e envie sua primeira requisição em 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"}'Início rápido.
- 01etapa
Obtenha um access token
Faça login no painel da Acepeak, abra Desenvolvedores → Tokens e crie um novo bearer token. Os tokens têm escopo por ambiente (sandbox ou produção) e são rotacionáveis no painel a qualquer momento.
Atenção — mantenha os tokens de produção no lado do servidor. Tudo que toca um navegador deve passar pelo seu backend.
- 02etapa
Autenticar
Cada requisição usa autenticação por bearer-token no cabeçalho Authorization.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
- 03etapa
Envie sua primeira requisição
Faça uma chamada, envie um SMS ou liste seus números — escolha o que se ajusta ao seu caso de uso. Você deve ver uma lista JSON dos seus números de telefone. A partir daí, você pode fazer chamadas, enviar SMS, configurar webhooks e começar a construir.
curl https://endpoints.acepeak.com/v1/numbers \ -H "Authorization: Bearer $ACEPEAK_TOKEN"
Cada recurso da plataforma é exposto via REST.
Chamadas de voz
Faça chamadas de saída, controle chamadas de entrada, transfira, faça conferência, grave, transcreva. Fluxos programáveis de answer-URL, captura de DTMF durante a chamada, streaming em tempo real.
/v1/calls/v1/conferences/v1/recordingsMensagens (SMS e MMS)
Envie e receba em números 10DLC dos EUA, gratuitos e short-code. Bidirecional, recibos de entrega, conformidade de opt-out, mensagens longas concatenadas.
/v1/messages/v1/messages/inboundNúmeros de telefone
Pesquise, compre, porte e libere. DIDs locais dos EUA, gratuitos e internacionais em mais de 60 países.
/v1/numbers/v1/numbers/available/v1/numbers/port-ordersUsuários e Equipes
Provisione usuários, atribua funções, gerencie equipes, configure SSO. SCIM 2.0 para gestão automatizada de ciclo de vida com seu IdP.
/v1/users/v1/teams/v1/ssoWebhooks
Entrega em tempo real de eventos de chamadas, mensagens e gravações ao seu endpoint. Assinados com HMAC-SHA256, reenviados com backoff exponencial por 24h.
/v1/webhooks/v1/webhooks/{id}/eventsRecursos de IA
Acione o AI Receptionist, extraia transcrições, obtenha pontuações de sentimento por chamada ou por chat.
/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentimentFormas de autenticação.
Autenticação por token de acesso
Recomendado para serviços de backend. Token Bearer enviado em cada requisição. Os tokens têm escopo por ambiente, são rotacionáveis a partir do painel e vinculados a uma função específica para acesso de menor privilégio.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
OAuth 2.0
Para aplicativos de parceiros e integrações de marketplace. Concessão de Authorization Code com PKCE. Use quando seu aplicativo agir em nome de um cliente, e não da sua própria conta.
- Authorization Code + PKCE
- Refresh tokens · 30 dias por padrão
- Escopo por cliente
Previsíveis, documentados e nunca silenciosos.
Limites de taxa
Padrão: 100 r/s por token de acesso. Picos de até 200 r/s por curtos períodos. Quando excedido, a plataforma retorna 429 com um cabeçalho Retry-After.
Idempotência
Requisições que alteram dados suportam um cabeçalho Idempotency-Key . Use-o em requisições POST, PUT e DELETE para que as repetições não cobrem ou enviem em duplicidade.
Códigos de erro
400Requisição inválidaFalha na validação401Não autorizadoToken de acesso inválido ou ausente403ProibidoO token não tem escopo404Não encontradoRecurso não encontrado409ConflitoIncompatibilidade de idempotência ou estado429Taxa limitadaReduza o ritmo — Retry-After fornecido5xxLado do servidorTente novamente com backoff exponencial
Eventos em tempo real entregues ao seu endpoint.
Inscreva um endpoint HTTPS em eventos de chamada, mensagem e gravação. Os webhooks são assinados com HMAC-SHA256 — verifique a assinatura antes de processar. Entregas com falha são repetidas com backoff exponencial por até 24 horas. Você pode reprocessar qualquer evento a partir do painel.
{
"id": "evt_01HW3...",
"type": "call.completed",
"created_at": "2026-04-30T10:42:00Z",
"data": {
"call_id": "CA_01HW...",
"duration_sec": 184
}
}Bibliotecas de primeira classe, espelhadas no REST.
URLs estáveis. Atualizações previsíveis.
As versões da interface são fixadas na URL (/v1/). Mudanças incompatíveis são lançadas em uma nova versão principal. Adições compatíveis chegam na mesma versão com uma nota no changelog do desenvolvedor.
Os recursos permanecem ativos por 12 meses após um aviso de descontinuação. Enviamos e-mail a cada equipe com um token de acesso ativo aos 90, 30 e 7 dias antes do encerramento — sem surpresas em produção.
Pronto para começar a construir?
Dúvidas, respondidas.
É uma interface REST mais webhooks assinados que expõe chamadas de voz, SMS / MMS, números de telefone, usuários e recursos de IA. Autentique-se com um bearer access token, acesse os endpoints documentados e entregue em minutos.
Construa sobre a api, lance no mesmo dia.
Suporte 24/7 incluído. Números portados de qualquer operadora no mundo.