Guia de Arquitetura de API de Voz

As APIs de voz são orientadas a eventos: a plataforma chama o seu sistema à medida que a chamada avança.

• Compreenda os eventos do ciclo de vida da chamada (iniciada, a tocar, atendida, concluída) que a sua API emite.O seu manipulador de webhooks é, na prática, a máquina de estados do fluxo de chamada — conceba-o como tal.
• Modele o controlo de chamadas como manipuladores de webhooks idempotentes que tolerem repetições e eventos fora de ordem.
• Decida entre documentos de fluxo de chamada declarativos e controlo de API em direto, consoante o caso de uso.
• Trate os conceitos de SIP que não pode evitar: media antecipada, DTMF, transferência e semântica de re-INVITE.
• Planeie a estratégia de numeração (E.164), a apresentação do identificador de chamada, e as regras de identificador de chamada por mercado.

• Escolha os codecs deliberadamente: G.711 para qualidade, G.729/Opus onde a largura de banda é limitada.Orçamente a largura de banda incluindo o overhead de IP/UDP/RTP, não apenas o débito binário do codec.
• Defina um intervalo de empacotamento sensato (normalmente 20 ms) equilibrando o overhead com a latência.
• Conceba para jitter, perda de pacotes e latência: buffers de jitter, e expectativas realistas de MOS.
• Planeie o tratamento de DTMF (RFC 2833/SIP INFO/in-band) de forma consistente ao longo do caminho.
• Decida cedo as necessidades de gravação e transcrição — afetam o encaminhamento e o armazenamento de media.

• Verifique as assinaturas dos webhooks e rejeite eventos não assinados ou obsoletos.Um webhook de controlo de chamadas não autenticado é um risco de tomada de controlo.
• Responda aos webhooks rapidamente e faça o trabalho pesado de forma assíncrona para não bloquear a chamada.
• Torne os manipuladores idempotentes e elimine duplicações por ID de evento, já que as repetições são esperadas.
• Correlacione os segmentos de chamada com um ID de chamada/sessão estável ao longo de transferências e conferências.

• Dimensione os canais concorrentes a partir de CPS × duração média da chamada, e acrescente margem para o pico.Chamadas concorrentes ≈ chamadas por segundo × duração média em segundos.
• Aprovisione a capacidade de troncos/canais e confirme os limites de concorrência e CPS do fornecedor.
• Escale os manipuladores de webhooks horizontalmente e mantenha-os sem estado atrás de uma fila.
• Faça testes de carga no pico de concorrência e confirme uma degradação graciosa, não uma falha abrupta.

• Encripte a sinalização (SIP sobre TLS) e a media (SRTP) onde disponível; restrinja por lista de permissões de IP.
• Proteja-se contra fraude de tarifação e Wangiri: limite a taxa e restrinja destinos premium de alto risco.
• Conceba a comutação por falha entre regiões/fornecedores para que uma única interrupção não derrube todas as chamadas.
• Registe os detalhes de chamada (CDRs) e eventos, e retenha o áudio apenas conforme as suas regras de conformidade.
• Instrumente métricas de qualidade (MOS, ASR, ACD) e alerte para quebras por rota.