Loading
IA generativa do Agentforce e do Einstein
Incluir cabeƧalhos de SIP personalizados e suporte para REFER

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

Dica
Dica Como retornar cabeçalhos de entrada altera o comportamento do sistema, configure e teste esse recurso em um ambiente de sandbox antes de habilitar essa configuração em produção.
  1. Em Configuração, na caixa Busca rÔpida, insira Agentforce Voice e selecione Configuração do Agentforce Voice.
  2. Em Etapas de configuração na pÔgina Configuração do Agentforce Voice, selecione a guia SIP/Roteamento dinâmico.
  3. 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.

  1. Em Configuração, insira Fluxos na caixa Busca rÔpida e selecione Fluxos.
  2. Para abrir seu fluxo de escalação no Flow Builder, selecione-o.
  3. 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.
  4. 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.
  5. 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.
    1. Para Como localizar registros para atualizar e definir seus valores, selecione Especificar condiƧƵes para identificar registros e definir campos individualmente.
    2. Para Objeto, selecione Dados de sessão de chamada de voz.
    3. Para Requisitos de condição para atualizar registros, especifique Todas as condições são atendidas (E) Voice Call ID Igual a recordId.
    4. 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.
    5. 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__c se torna X-Account-ID como cabeçalho. Para evitar que cabeçalhos sejam incluídos em solicitações, defina o valor do campo como nulo (em branco).
    Elemento Atualizar registros no Flow Builder mostrando campos de Dados da sessão de chamada de voz, incluindo Método de desconexão de SIP definido como SIP_REFER, Referência de SIP ao URI, SIP indicado por informações e um campo personalizado de ID da conta X.

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.

  1. Em Configuração, insira Fluxos na caixa Busca rÔpida e selecione Fluxos.
  2. 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.
  3. 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.
  4. Adicione um elemento Atualizar registros para atualizar os campos de Dados de sessão de chamada de voz.
    1. Para Como localizar registros para atualizar e definir seus valores, selecione Especificar condiƧƵes para identificar registros e definir campos individualmente.
    2. Para Objeto, selecione Dados de sessão de chamada de voz.
    3. Para Requisitos de condição para atualizar registros, especifique Todas as condições são atendidas (E) Voice Call ID Igual a recordId.
    4. 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.
    5. 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__c se torna X-Account-ID como 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.

  1. Em Configuração, insira Fluxos na caixa Busca rÔpida e selecione Fluxos.
  2. Para abrir o fluxo de entrada do Omni-Channel no Flow Builder, selecione-o.
  3. 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.

 
Carregando
Salesforce Help | Article