Projete uma sequência de chamada

Warning: Voice sequences are in preview. Steps, entry data, and the sequence definition format can change in ways that break existing sequences and API requests.

Defina as mensagens de voz, as opções de teclado, a gravação e o encerramento de uma chamada antes de configurar seu fluxo de trabalho. Use o construtor de sequências Voice para criar um fluxo de chamada Bird salvo. Se sua própria aplicação controla o fluxo, conecte-a por um trunk SIP.

Defina o resultado para quem liga

Escolha um resultado pequeno e observável. Um menu de informações de serviço pode oferecer horário de funcionamento em uma tecla e instruções de como chegar em outra. Escreva também a resposta para silêncio e para uma tecla não reconhecida, além das opções principais.

Mantenha ações de negócio externas na aplicação ou no runtime conversacional que as controla. Uma confirmação falada não garante que outro sistema agendou um compromisso ou alterou um pedido. Use o guia de integração de voz com IA quando a conversa depender de ferramentas e diálogo em tempo real.

Mapeie as etapas e dependências

1. Nomeie o ponto de entrada e cada destino. Liste os números de telefone e as aplicações externas que dependem deles.
2. Escreva os prompts e prepare o áudio. Especifique se o pressionamento de uma tecla deve interromper o prompt ou aguardar até que ele termine.
3. Defina ramificações para opções completas de teclado, silêncio e entrada não reconhecida. Atribua a cada ramificação um destino ou um encerramento explícito da chamada.
4. Se a aplicação gravar uma resposta, especifique quando a captura começa e termina, qual áudio é capturado e se é necessária transcrição. Mantenha dados sensíveis fora da janela de captura.
5. Verifique se as etapas da sequência selecionada ou a aplicação conectada suportam o comportamento necessário. Confirme o tratamento de entrada, a gravação e as operações de transferência antes de configurar o fluxo.

Mantenha a gravação, o processamento de transcrição e o resultado telefônico separados. O guia de gravações aborda consentimento, acesso e revisão dos artefatos gerados.

Conecte a aplicação

Para uma sequência Bird, crie e salve um rascunho, teste seus caminhos e publique uma versão. O guia do construtor aborda entradas de chamada, simulação, chamadas de teste reais e vinculação de número. Editar um rascunho não altera a publicação ativa; publicar uma sequência pausada a mantém pausada.

Para uma aplicação SIP externa, configure a conexão da seguinte forma.

Crie um trunk e ative a direção de chamada necessária. Para chamadas recebidas, ative a chamada de entrada, configure um gateway de entrega e aponte um número elegível para o trunk. O guia de recebimento de chamadas aborda o roteamento de números.

Para chamadas de saída, ative a chamada de saída e configure autenticação, identidade do chamador e acesso ao destino. Use o guia de chamadas SIP para preparar a conexão.

Configure as mensagens de voz e o comportamento do menu no sistema que controla o fluxo. Consulte a referência publicada de API, CLI ou MCP antes de usar uma operação. A leitura de registros de chamadas, a criação de sequências, a simulação e a criação de chamadas reais têm efeitos e permissões diferentes. Para iniciar uma sequência Bird via HTTP, siga Criar uma chamada de voz.

Teste antes de alterar a rota de produção

Use um número que você controla e um rascunho ou configuração de aplicação isolados. O guia da primeira chamada aborda a preparação da conexão. Uma simulação de sequência não realiza chamada; um teste real de rascunho realiza uma chamada e gera cobranças normais de chamada.

Teste entrada reconhecida, silêncio, tecla não reconhecida, prompts interrompidos e desligamento limpo. Verifique se cada ramificação alcança a resposta pretendida. Confira o estado de gravação e transcrição separadamente quando o fluxo os utilizar.

Coordene as edições durante o teste e registre a configuração testada. Mantenha a configuração anterior da aplicação e a rota de número disponíveis para restaurá-las caso o novo fluxo falhe. Restaurar o roteamento não desfaz uma ação de negócio já realizada.

Verifique o resultado da chamada

Use o registro de trecho para inspecionar o resultado telefônico. Uma chamada atendida, um menu concluído e uma tarefa de negócio concluída são resultados separados. Reconcilie os eventos de Voice com o registro de trecho quando atualizações estiverem ausentes ou chegarem fora de ordem.

Próximos passos

• Rotear chamadas recebidas
• Gravações e transcrições
• Conversas de voz com IA