Crie chamadas, mensagens e IA na API Acepeak.
Endpoints REST, webhooks em tempo real e SDKs de primeira classe. Autentique a API com um token de acesso ao portador e envie sua primeira solicitaçã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 token de acesso
Faça login no painel Acepeak, abra Desenvolvedores → Tokens e crie um novo token ao portador. Os tokens têm escopo definido por ambiente (sandbox ou live) e podem ser girados no painel a qualquer momento.
Atenção – mantenha os tokens ativos no lado do servidor. Qualquer coisa que toque em um navegador deve passar pelo seu back-end.
- 02etapa
Autenticar
Cada solicitação usa autenticação de token de portador no cabeçalho de autorização.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
- 03etapa
Envie sua primeira solicitação
Faça uma chamada, envie um SMS ou liste seus números – escolha o que melhor se adequa ao seu caso de uso. Você deverá ver uma lista JSON de 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"
Todos os recursos da plataforma é exposto via REST.
Chamadas de voz
Faça chamadas, controle chamadas recebidas, transfira, coloque em conferência, grave, transcreva. Fluxos de URL de resposta programáveis, captura DTMF na chamada, streaming em tempo real.
/v1/calls/v1/conferences/v1/recordingsMensagens (SMS e MMS)
Envie e receba em números 10DLC dos EUA, ligação gratuita e código curto. Bidirecional, recibos de entrega, conformidade com opt-out, mensagens longas concatenadas.
/v1/messages/v1/messages/inboundNúmeros de telefone
Pesquise, compre, transfira 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 e configure SSO. SCIM 2.0 para gerenciamento automatizado do ciclo de vida com seu IdP.
/v1/users/v1/teams/v1/ssoWebhooks
Entrega em tempo real de chamadas, mensagens e eventos de gravação para seu endpoint. HMAC-SHA256 assinado, nova tentativa com espera exponencial por 24h.
/v1/webhooks/v1/webhooks/{id}/eventsSuperfícies de IA
Acione a recepcionista de IA, extraia transcrições e obtenha pontuações de sentimento por chamada ou por chat.
/v1/ai/receptionist/v1/ai/transcripts/v1/ai/sentimentCaminhos para autenticar.
Autenticação de token de acesso
Recomendado para serviços de back-end. Token ao portador enviado em cada solicitação. Os tokens têm escopo definido por ambiente, podem ser girados no painel e vinculados a uma função específica para acesso com privilégios mínimos.
Authorization: Bearer YOUR_ACEPEAK_TOKEN
OAuth 2.0
Para aplicativos de parceiros e integrações de mercado. Concessão de código de autorização com PKCE. Use isso quando seu aplicativo agir em nome de um cliente e não em sua própria conta.
- Código de autorização + PKCE
- Atualizar tokens · Padrão de 30 dias
- Escopo por cliente
Previsível, documentado, e nunca silencioso.
Limites de taxa
Padrão: 100 r/s por token de acesso. Explode até 200 r/s para janelas curtas. Quando excedido, a plataforma retorna 429 com um cabeçalho Retry-After.
Idempotência
Solicitações de mutação suportam um Idempotency-Key cabeçalho. Use-o em solicitações POST, PUT e DELETE para que as novas tentativas não cobrem ou enviem duas vezes.
Códigos de erro
400Pedido ruimFalha na validação401Não autorizadoToken de acesso inválido ou ausente403ProibidoToken não tem escopo404Não encontradoRecurso não encontrado409ConflitoIdempotência ou incompatibilidade de estado429Taxa limitadaDesacelere – Repetir após fornecido5xxLado do servidorTentar novamente com espera exponencial
Eventos em tempo real entregue ao seu endpoint.
Assine um endpoint HTTPS para chamar, enviar mensagens e gravar eventos. Webhooks são assinados com HMAC-SHA256 — verifique a assinatura antes do processamento. As entregas com falha são repetidas com espera exponencial por até 24 horas. Você pode reproduzir qualquer evento no 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, mapeado em espelho para REST.
URLs estáveis. Atualizações previsíveis.
As versões da interface são fixadas no URL (/v1/). Mudanças importantes são enviadas por trás de uma nova versão principal. Adições ininterruptas chegam na mesma versão com uma nota de lançamento no changelog do desenvolvedor.
Os recursos permanecem ativos por 12 meses após um aviso de descontinuação. Enviamos um e-mail para cada equipe com um token de acesso ativo em 90, 30 e 7 dias antes do corte – sem surpresas na produção.
Pronto para começar a construir?
Questões, respondeu.
É uma interface REST mais webhooks assinados que expõe chamadas de voz, SMS/MMS, números de telefone, usuários e superfícies de IA. Autentique com um token de acesso ao portador, acesse os endpoints documentados e envie em minutos.
Construa na API, enviar no mesmo dia.
Suporte 24 horas por dia, 7 dias por semana incluído. Números portados de qualquer operadora do mundo.