Crie chamadas, mensagens e AI na api da Acepeak.
Endpoints REST, webhooks em tempo real e SDKs de primeira classe. Autentique a api com um token de acesso bearer e envie o seu primeiro pedido 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"}'Arranque rápido.
- 01passo
Obter um token de acesso
Inicie sessão no painel da Acepeak, abra Developers → Tokens e crie um novo token bearer. Os tokens têm âmbito por ambiente (sandbox ou live) e são rotacionáveis a partir do painel a qualquer momento.
Atenção — mantenha os tokens live no lado do servidor. Tudo o que toque num navegador deve passar pelo seu backend.
- 02passo
Autenticar
Cada pedido usa autenticação por token bearer no cabeçalho Authorization.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
- 03passo
Envie o seu primeiro pedido
Faça uma chamada, envie um SMS ou liste os seus números — escolha o que se adequa ao seu caso de uso. Deverá ver uma lista JSON dos seus números de telefone. A partir daí, pode fazer chamadas, enviar SMS, configurar webhooks e começar a construir.
curl https://endpoints.acepeak.com/v1/numbers \ -H "Authorization: Bearer $ACEPEAK_TOKEN"
Todas as capacidades da plataforma são expostas via REST.
Chamadas de voz
Faça chamadas de saída, controle chamadas de entrada, transfira, faça conferência, grave e 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, gratuitos e short-code dos EUA. Bidirecional, recibos de entrega, conformidade de opt-out, mensagens longas concatenadas.
/v1/messages/v1/messages/inboundNúmeros de telefone
Pesquise, compre, porte e liberte. DIDs locais dos EUA, gratuitos e internacionais em 60+ países.
/v1/numbers/v1/numbers/available/v1/numbers/port-ordersUtilizadores e Equipas
Aprovisione utilizadores, atribua funções, faça a gestão de equipas e configure o SSO. SCIM 2.0 para gestão automatizada do ciclo de vida com o seu IdP.
/v1/users/v1/teams/v1/ssoWebhooks
Entrega em tempo real de eventos de chamada, mensagem e gravação para o seu endpoint. Assinados com HMAC-SHA256, repetidos com recuo exponencial durante 24h.
/v1/webhooks/v1/webhooks/{id}/eventsSuperfícies de AI
Acione o AI Receptionist, obtenha transcrições e busque pontuações de sentimento por chamada ou por chat.
/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentimentFormas de autenticar.
Autenticação por token de acesso
Recomendado para serviços de backend. Token bearer enviado em cada pedido. Os tokens têm âmbito por ambiente, são rotacionáveis a partir do painel e estão associados a uma função específica para acesso de privilégio mínimo.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
OAuth 2.0
Para aplicações de parceiros e integrações de marketplace. Concessão Authorization Code com PKCE. Use isto quando a sua aplicação atua em nome de um cliente em vez da sua própria conta.
- Authorization Code + PKCE
- Tokens de atualização · 30 dias por predefinição
- Âmbito por cliente
Previsíveis, documentados e nunca silenciosos.
Limites de taxa
Predefinição: 100 r/s por token de acesso. Picos até 200 r/s em janelas curtas. Quando excedido, a plataforma devolve 429 com um cabeçalho Retry-After.
Idempotência
Os pedidos de mutação suportam um cabeçalho Idempotency-Key . Use-o em pedidos POST, PUT e DELETE para que as repetições não cobrem nem enviem em duplicado.
Códigos de erro
400Pedido inválidoValidação falhou401Não autorizadoToken de acesso inválido ou em falta403ProibidoO token não tem âmbito404Não encontradoRecurso não encontrado409ConflitoIncompatibilidade de idempotência ou de estado429Limite de taxa atingidoAbrande — Retry-After fornecido5xxLado do servidorRepita com recuo exponencial
Eventos em tempo real entregues no seu endpoint.
Subscreva um endpoint HTTPS a eventos de chamada, mensagem e gravação. Os webhooks são assinados com HMAC-SHA256 — verifique a assinatura antes de processar. As entregas falhadas são repetidas com recuo exponencial durante até 24 horas. Pode reproduzir 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, mapeadas espelho a espelho com REST.
URLs estáveis. Atualizações previsíveis.
As versões da interface estão fixadas no URL (/v1/). As alterações disruptivas são entregues numa nova versão principal. As adições não disruptivas chegam na mesma versão com uma nota de lançamento no changelog de programadores.
As funcionalidades permanecem ativas durante 12 meses após um aviso de descontinuação. Enviamos email a cada equipa com um token de acesso ativo aos 90, 30 e 7 dias antes do prazo — sem surpresas em produção.
Pronto para começar a construir?
Perguntas, respondidas.
É uma interface REST mais webhooks assinados que expõe chamadas de voz, SMS / MMS, números de telefone, utilizadores e superfícies de AI. Autentique-se com um token de acesso bearer, aceda aos endpoints documentados e coloque em produção em minutos.
Construa na api, lance no mesmo dia.
Apoio 24/7 incluído. Números portados de qualquer operadora a nível mundial.