Pular para o conteúdo principal
Acepeak
Desenvolvedores

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.

Obtenha um token de acesso·Ver preços
local-chamada.sh
# 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"}'
Cinco minutos para sua primeira ligação

Início rápido.

  1. 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.

  2. 02etapa

    Autenticar

    Cada solicitação usa autenticação de token de portador no cabeçalho de autorização.

    Authorization: Bearer YOUR_ACEPEAK_TOKEN
  3. 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"
O que você pode construir

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/recordings

Mensagens (SMS e MMS)

Envie e receba nos EUA 10DLC, números gratuitos e números de código curto. Bidirecional, recibos de entrega, conformidade com opt-out, mensagens longas concatenadas.

/v1/messages/v1/messages/inbound

Números de telefone

Pesquise, compre, transfira e libere. Local nos EUA, ligação gratuita e internacional DIDs em mais de 60 países.

/v1/numbers/v1/numbers/available/v1/numbers/port-orders

Usuá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/sso

Webhooks

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}/events

Superfí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/sentiment
Autenticação

Caminhos 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
Limites e erros de taxa

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ção
  • 401Não autorizadoToken de acesso inválido ou ausente
  • 403ProibidoToken não tem escopo
  • 404Não encontradoRecurso não encontrado
  • 409ConflitoIdempotência ou incompatibilidade de estado
  • 429Taxa limitadaDesacelere – Repetir após fornecido
  • 5xxLado do servidorTentar novamente com espera exponencial
Webhooks

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.

POST · /seu-webhookAssinado
{
  "id": "evt_01HW3...",
  "type": "call.completed",
  "created_at": "2026-04-30T10:42:00Z",
  "data": {
    "call_id": "CA_01HW...",
    "duration_sec": 184
  }
}
HMAC-SHA256 assinado · seguro para reprodução
Novas tentativas de espera exponencial de 24 horas
Reproduza qualquer evento do painel
Filtrar por tipo de evento · por endpoint
SDKs

Bibliotecas de primeira classe, mapeado em espelho para REST.

GitHub·OpenAPI 3.1
Node.jsnpm install @acepeak/sdkInstalar
Pitãopip install acepeakInstalar
PHPcomposer require acepeak/sdkInstalar
Irgo get github.com/acepeak/acepeak-goInstalar
Rubigem install acepeakInstalar
Licença MIT · mesma cadência de lançamento da plataformaCarteiro →
Versionamento

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.

Política de depreciação

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?

Contate-nos Ver preços
Perguntas frequentes

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.

REST · webhooks · SDKs

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.

devs.acepeak.com·github.com/acepeak·devs@acepeak.com
Contate-nos Ver preços
Suporte 24 horas por dia, 7 dias por semanaMais de 60 paísesSOC 2 IIConsole sandbox
Última atualização: maio de 2026
Contate-nos Ver preços