Moraviq Voice para desenvolvedoresAPI v2

Moraviq Voice para desenvolvedores

Chamadas de voz da portaria para o morador (e de volta), com WebRTC, sinalização própria, TURN no Brasil e push. Você integra no seu sistema de condomínio de dois jeitos: com os SDKs (o seu app, a sua tela) ou com o white label (o nosso app com a sua marca). Esta documentação é a do SDK e da API v2.

Primeira chamada em 15 minutosSandbox, chaves, portaria e morador de exemplo, uma chamada de verdade. AutenticaçãoJWT do seu backend com EdDSA ou ES256; nada de segredo compartilhado. API v2Sites, postos, chamadas, aparelhos, idempotência. WebhooksStandard Webhooks, 8 tentativas em cerca de 23 h. SDKsJavaScript e Angular hoje; Android, iOS, Capacitor e Flutter na sequência. Erros e limitesCódigos fechados, cotas e o que fazer em cada um.

Como uma chamada acontece

  1. O visitante chega; o porteiro escolhe a unidade na sua portaria.
  2. O seu backend decide quem toca e cria a chamada: POST /v2/calls com callees (os ext_id dos moradores, os seus identificadores). O Voice nunca recebe nome, CPF ou telefone.
  3. A aba da portaria entra na chamada com o próprio token (attachOutgoing no SDK). A resposta do POST /v2/calls não traz token.
  4. Os aparelhos dos moradores tocam (WebSocket com o app aberto, push com ele fechado). O primeiro que atende fica com a chamada; os outros param de tocar.
  5. Áudio direto entre as pontas quando a rede deixa, pelo TURN quando não deixa. O Voice não grava áudio.
  6. O seu backend recebe call.ringing, call.answered e call.finished por webhook assinado, e registra o desfecho (allowed, denied, no_response). Abrir o portão é decisão do seu sistema, nunca do Voice.

Ambientes

AmbienteAPIPara quê
Sandboxhttps://sandbox.<host> (piloto: o sandbox local, passo 1)grátis, limite diário de chamadas, dados apagados em 30 dias, chaves próprias de sandbox
Produçãohttps://api.voice.moraviq.com.brchaves de produção, emitidas no console com a confirmação do dono da conta

Sandbox e produção são implantações e bancos separados: uma chave de sandbox nunca abre a produção, e vice-versa.

O que muda do perfil Moraviq (v1)

O /v1 é o perfil do app Moraviq e está congelado. Parceiros usam só o /v2: identificadores do parceiro (ext_id), chaves por parceiro, webhooks Standard, idempotência por cabeçalho e erros com request_id.