VocĆŖ estĆ” aqui:
Incluir cabeƧalhos de SIP personalizados e suporte para REFER
Aumente a quantidade de informaƧƵes passadas com solicitaƧƵes SIP com cabeƧalhos SIP X personalizados e manipule as desconexƵes com mais facilidade com SIP REFER.
Edições obrigatórias
| DisponĆvel em: Lightning Experience |
| DisponĆvel em: EdiƧƵes Enterprise, Unlimited e Developer com EdiƧƵes Foundations ou Agentforce 1 e extensƵes do Salesforce Voice. |
| PermissƵes necessƔrias ao usuƔrio | |
|---|---|
| Para abrir, editar ou criar um fluxo no Flow Builder: | Gerenciar fluxo |
Antes de começar, trabalhe com seu parceiro SIP para garantir que suas solicitações SIP incluam cabeçalhos X ou cabeçalhos personalizados que você possa consultar em seus fluxos. Para usar SIP REFER, verifique se seu parceiro oferece suporte a esse protocolo para desconexões.
Para começar, ative uma configuração para capturar cabeçalhos SIP personalizados em chamadas de entrada e passar dados contextuais avançados, como intenção do cliente, preferência de idioma ou informações de autenticação para o Agentforce Voice. Para lidar com desconexões ao escalar para um representante, defina o método de desconexão como SIP REFER no fluxo de escalação. Para lidar com qualquer outro tipo de desconexão não escalonada, como pendura automÔtica do agente ou encerramento da sessão do agente devido à ausência de resposta do cliente, defina o método de desconexão como SIP REFER no fluxo de fallback. Em ambos os cenÔrios de desconexão, o Controlador de borda de sessão (SBC) ou a plataforma de telefonia redireciona a chamada para um URI usando o cabeçalho de resposta de URI Referência a. Você também pode escolher definir o método de desconexão como SIP BYE, se necessÔrio.
Considerações sobre Cabeçalhos personalizados e referência de SIP
- Os valores de cabeçalho X personalizados têm um comprimento mÔximo de 255. Esse limite não se aplica a cabeçalhos X-SF, como X-SF-Token.
- O número mÔximo de cabeçalhos SIP personalizados é baseado no limite de campos personalizados permitidos por objeto para o objeto Dados de sessão de chamada de voz. Campos padrão e cabeçalhos X-SF não contam para esse limite.
- O Salesforce recebe valores de cabeçalho enviados em um CONVITE SIP e os retorna em uma resposta. Você pode atualizar um valor de cabeçalho em um fluxo para que o valor da resposta seja diferente. Para não retornar um cabeçalho, defina o valor do campo como nulo.
- Se vocĆŖ usar SIP REFER, deverĆ” definir um valor de URI Referenciar no objeto VoiceCallSessionData.
Ative a configuração Incluir cabeçalhos SIP personalizados e REFERIR suporte
- Em Configuração, na caixa Busca rÔpida, insira Agentforce Voice e selecione Configuração do Agentforce Voice.
- Em Etapas de configuração na pÔgina Configuração do Agentforce Voice, selecione a guia SIP/Roteamento dinâmico.
-
Ative Incluir cabeƧalhos SIP personalizados e suporte REFER.
A configuração entra em vigor em cinco a dez minutos.
Criar campos personalizados para dados de sessão de chamada de voz
Como opção, para enviar cabeçalhos personalizados na solicitação REFER ou BYE, crie campos personalizados no objeto Dados de sessão de chamada de voz. O Salesforce passa campos padrão de Dados de sessão de chamada de voz e valores de campo personalizados como cabeçalhos de SIP em solicitações. Para campos personalizados,
X_Account_ID__c torna-se X-Account-ID como cabeƧalho, substituindo sublinhados por hifens. Consulte Criar um campo personalizado para obter mais informaƧƵes.
Você não precisa criar campos personalizados para enviar cabeçalhos X-SF, como X-SF-Token, ou para enviar campos padrão no objeto Dados de sessão de chamada de voz como cabeçalhos.
Editar o fluxo de escalação
Edite o fluxo do Omni-Channel de saĆda que encaminha as conversas do seu agente para outro destino, como um representante de serviƧo, fila ou agente diferente. Use esse fluxo para selecionar o protocolo para desconexƵes e quaisquer cabeƧalhos personalizados que vocĆŖ queira enviar com solicitaƧƵes SIP.
- Em Configuração, insira Fluxos na caixa Busca rÔpida e selecione Fluxos.
- Para abrir seu fluxo de escalação no Flow Builder, selecione-o.
- Certifique-se de que o fluxo tenha uma variĆ”vel de entrada recordId que armazene o ID de registro de chamada de voz. O tipo de dados Ć© Text e a variĆ”vel Ć© DisponĆvel para entrada. Crie essa variĆ”vel se ela nĆ£o existir.
-
Opcionalmente, adicione um elemento Obter registros para obter dados de registros de Chamada de voz para uso em uma solicitação SIP REFER na próxima etapa.
Por exemplo, armazene o valor do Número de telefone de destino em uma variÔvel para uso no valor de SIP Indicado por informações.
-
Para atualizar campos no registro de Dados de sessão de chamada de voz da sessão, adicione um elemento Atualizar registros. Cada registro de Dados de sessão de chamada de voz armazena temporariamente metadados da sessão, incluindo cabeçalhos SIP personalizados.
- Para Como localizar registros para atualizar e definir seus valores, selecione Especificar condiƧƵes para identificar registros e definir campos individualmente.
- Para Objeto, selecione Dados de sessão de chamada de voz.
- Para Requisitos de condição para atualizar registros, especifique Todas as condições são atendidas (E) Voice Call ID Igual a recordId.
-
Para lidar com desconexões usando SIP REFER para situações em que uma escalação de um agente para outro destino falha, defina o campo Método de desconexão de SIP como SIP_REFER. Defina o campo URI de referência de SIP para seu valor preferencial de URI de referência de SIP, para o qual a chamada deve ser enviada. Também recomendamos configurar o campo SIP Indicado por informações para identificar o usuÔrio ou a entidade que iniciou a transferência da chamada. Para lidar com desconexões durante uma escalação com SIP BYE, deixe Método de desconexão SIP para seu valor padrão, SIP_BYE.
Para obter mais informaƧƵes sobre os campos disponĆveis, consulte VoiceCallSessionData.
-
Opcionalmente, defina cabeçalhos personalizados ou atualize valores de cabeçalho para enviar informações de volta para o SBC ou a plataforma de telefonia na solicitação REFER ou BYE.
O Salesforce passa os valores do campo Dados da sessão de chamada de voz como cabeçalhos SIP em solicitações. Para campos personalizados,
X_Account_ID__cse tornaX-Account-IDcomo cabeƧalho. Para evitar que cabeƧalhos sejam incluĆdos em solicitaƧƵes, defina o valor do campo como nulo (em branco).
Criar um fluxo de fallback
Para lidar com situaƧƵes em que uma chamada entre um agente e um cliente Ć© desconectada, como quando um cliente para de falar por um perĆodo estendido (pendura semĆ¢ntica), quando um agente encerra abruptamente a sessĆ£o devido a um problema ou se houver uma desconexĆ£o durante a escalação, crie um fluxo de fallback iniciado automaticamente. Use esse fluxo para selecionar o protocolo SIP e quaisquer cabeƧalhos personalizados que vocĆŖ queira enviar em caso de desconexĆ£o.
- Em Configuração, insira Fluxos na caixa Busca rÔpida e selecione Fluxos.
- Clique em Novo fluxo e crie um fluxo iniciado automaticamente. Para evitar roteamento adicional, não use um fluxo do Omni-Channel para essa etapa.
- Crie uma variĆ”vel de entrada que armazene o ID do registro de chamada de voz. DĆŖ Ć variĆ”vel o nome recordId, defina o tipo de dados como Text, selecione DisponĆvel para entrada e clique em ConcluĆdo.
-
Adicione um elemento Atualizar registros para atualizar os campos de Dados de sessão de chamada de voz.
- Para Como localizar registros para atualizar e definir seus valores, selecione Especificar condiƧƵes para identificar registros e definir campos individualmente.
- Para Objeto, selecione Dados de sessão de chamada de voz.
- Para Requisitos de condição para atualizar registros, especifique Todas as condições são atendidas (E) Voice Call ID Igual a recordId.
-
Para lidar com desconexões usando SIP REFER, defina o campo Método de desconexão SIP como SIP_REFER. Defina o campo URI de referência de SIP para seu valor preferencial de URI de referência de SIP, para o qual a chamada deve ser enviada. Também recomendamos configurar o campo SIP Indicado por informações para identificar o usuÔrio ou a entidade que iniciou a transferência da chamada. Para lidar com desconexões durante uma escalação com SIP BYE, deixe Método de desconexão SIP para seu valor padrão, SIP_BYE.
Para obter mais informaƧƵes sobre os campos disponĆveis, consulte VoiceCallSessionData.
-
Opcionalmente, defina cabeçalhos personalizados ou atualize valores de cabeçalho para enviar informações de volta para o SBC ou a plataforma de telefonia na solicitação REFER ou BYE.
O Salesforce passa os valores do campo Dados da sessão de chamada de voz como cabeçalhos SIP em solicitações. Para campos personalizados,
X_Account_ID__cse tornaX-Account-IDcomo cabeƧalho. Para evitar que cabeƧalhos sejam incluĆdos, defina o valor do campo como nulo (em branco).
Atualizar o fluxo de entrada
Para especificar o fluxo iniciado automaticamente de fallback, atualize o fluxo do Omni-Channel de entrada para o agente. O Salesforce usa o Nome da API de fluxo de fallback do registro de Dados de sessão de chamada de voz para identificar o fluxo de fallback.
- Em Configuração, insira Fluxos na caixa Busca rÔpida e selecione Fluxos.
- Para abrir o fluxo de entrada do Omni-Channel no Flow Builder, selecione-o.
-
Adicione um elemento Atualizar registros para atualizar dados de sessão de chamada de voz. Defina o campo Nome da API de fluxo de fallback para o nome da API do fluxo de fallback que você criou anteriormente.
Se você não especificar um fluxo de fallback, no caso de uma desconexão, o Salesforce enviarÔ SIP_BYE como o método de desconexão e nenhum cabeçalho personalizado.
Depois de testar chamadas recebidas em seu sandbox, repita as etapas neste artigo para ativar a configuração e configurar fluxos em produção.
