Pular para o conteúdo

SayWordy para desenvolvedores

Idiomas diferentes.
Uma conexão.

Adicione conversas telefônicas traduzidas ao seu produto. Verifique a tarifa, conecte duas pessoas e acompanhe a conversa com um único saldo pré-pago.

Chamadas telefone-para-telefone · Destinos suportados nos EUA · API server-side

01CotaçãoSaiba o preço
02ConectarAceitar e discar
03TraduzirAcompanhar a chamada

Um começo simples

Cote. Ligue. Fique por dentro.

Mantenha as chaves no seu servidor.
Seus usuários mantêm o controle de cada chamada.

curl https://saywordy.com/api/v1/quotes \
  -H "Authorization: Bearer $SayWordy_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "you": {"phoneNumber": "+12025550101", "language": "en", "voice": "female"},
      "them": {"phoneNumber": "+12025550102", "language": "es", "voice": "male"},
      "recording": false,
      "hearOriginal": true
    }
  }'

Os números de telefone de exemplo são reservados para documentação. Substitua-os apenas quando pretender fazer uma chamada real e paga. Use uma chave de teste para solicitações simuladas. O modo de teste nunca disca nem cobra do seu saldo. Uma cotação nunca inicia uma chamada.

Testar o fluxo

Uma prévia, sem o telefone tocar.

Execute este exemplo local para ver como funciona a verificação de preço. Ele usa uma tarifa fictícia de 30 créditos e não faz requisições de API, buscas ou chamadas telefônicas.

Sua cotação de exemplo aparecerá aqui.

Nenhuma chave de API necessária.

Chaves com limites.

Crie chaves com escopo e limite de gastos. Revogue o acesso da sua conta. Nunca coloque uma chave secreta no código do navegador ou do cliente móvel.

Uma única fonte de verdade.

A cotação de servidor aceita define o preço da chamada. Os segundos conectados são descontados da mesma carteira que você usa no SayWordy.

Baseado no consentimento.

Ambos os participantes devem aceitar antes da conexão. A gravação é opcional e requer a concordância de ambos. Não há cobrança de conversa em caso de falha na configuração.

O que esperar da API

Autenticação
Authorization: Bearer YOUR_KEY. As chaves são restritas ao seu espaço de trabalho e chamadas autorizadas.
Cotações
Verifique ambos os números antes de ligar. Uma cotação inclui sua validade e tarifa. Números alterados ou cotações expiradas exigem uma nova verificação.
Tentativas
Use uma chave de idempotência única para cada chamada pretendida e reutilize essa chave ao tentar a mesma solicitação novamente.
Uso
Ambas as conexões telefônicas e a tradução estão incluídas na tarifa por minuto aceita. A cobrança utiliza segundos conectados e créditos fracionados.
Disponibilidade
O acesso depende da sua conta, rotas configuradas e créditos disponíveis. Destinos desconhecidos, premium ou não suportados não podem ser chamados.

Para onde queremos ir a seguir

Uma carteira. Mais formas de se conectar.

Chamadas diretas via navegador e app nativo, além de integrações de vídeo e reuniões, estão em nosso roadmap. Elas não estão disponíveis atualmente através desta API.

Explore os preços