Compartir por

Usar CCaaS_CreateProactiveVoiceDelivery API (previsualización)

[Este artigo é a documentación de prelanzamento e está suxeito a cambios.]

Podes usar a CCaaS_CreateProactiveVoiceDelivery API para iniciar chamadas de voz proactivas de saída aos clientes ou permitir aos clientes programar chamadas a través do servizo de compromiso proactivo.

Importante

Se unha organización está a usar a CCaaS_CreateProactiveVoiceDelivery API para iniciar unha chamada de voz de saída, a organización é responsable da xestión do consentimento, incluída a actualización manual das "listas de non chamadas" para establecer horarios de silencio para o contacto co cliente. Asegúrese de que se cumpren as seguintes condicións:

  • Obtívose o consentimento adecuado antes de contactar cos clientes
  • Os clientes póñense en contacto só durante as horas permitidas.

Importante

  • Esta é unha funcionalidade de vista previa.
  • As funcionalidades en versión preliminar non están destinadas a usarse en produción e poderían ter restrinxida a funcionalidade. Estas funcións están suxeitas a termos de uso adicionais e están dispoñibles antes dun lanzamento oficial para que os clientes poidan acceder anticipadamente e proporcionar comentarios.

Requisitos previos

Iniciar chamadas proactivas de saída

O compromiso proactivo permite ás organizacións mellorar as interaccións cos clientes iniciando comunicacións saíntes a través da canle de voz. Podes configurar un compromiso proactivo usando unha viaxe de Customer Insights ou o CCaaS_CreateProactiveVoiceDelivery.

A CCaaS_CreateProactiveVoiceDelivery API permite ás organizacións iniciar chamadas de voz proactivas de saída aos clientes a través do servizo de compromiso proactivo. A API desencadea chamadas de voz saíntes a través do sistema Voice Runtime. As chamadas realízanse de acordo co modo de marcación configurado, xa sexa inmediatamente (se non se especifican xanelas horarias) ou durante as xanelas horarias designadas que proporciona.

Esta API permite aos centros de contacto chegar aos clientes no momento adecuado con información, recordatorios ou notificacións relevantes, mellorando a experiencia do cliente ao tempo que optimiza a eficiencia operativa.

Detalles da solicitude

  • URL:https://<orgurl>/api/data/v9.2/CCaaS_CreateProactiveVoiceDelivery
  • Método: POST
  • Versión: 1.0
  • Operación OData: Acción
  • Tipo de OData: Sen límites
  • Solicitude de autorización: Requírese. Debe conter un token Azure AD Bearer válido para o usuario que realiza a chamada API. Este token debe ser emitido desde o mesmo inquilino de Azure AD que a instancia do servizo ao cliente.

Cabeceiras de solicitude

Clave Tipo Descrición
ApiVersion Cadea Versión da API CCaaS.
ProactiveEngagementConfigId Cadea ID da configuración de compromiso proactivo a usar. Isto especifica o tipo de modo de marcación, o fluxo de traballo e o perfil de saída a usar. Para obter este identificador, faga o seguinte:
  1. Vai a Power Apps e selecciona o ambiente requirido.
  2. Seleccionar táboas>Configuración de compromiso proactivo
  3. Seleccione o identificador do rexistro requirido.
Número de teléfono de destino Cadea Número de teléfono do cliente ao que chamar.
Identificador de contacto Cadea Identificación do contacto do cliente en Dynamics CRM.
Ventás Matrice JSON de obxectos de fiestra Especifica os períodos de tempo válidos nos que se pode realizar a chamada de saída. Se non se proporciona, o sistema por defecto ten unha xanela de 24 horas que comeza inmediatamente (desde a hora actual ata as 24 horas despois).
Atributos de entrada Obxecto JSON das cadeas de valor da chave Opcional. Variables que se poden referenciar dentro dos fluxos de axentes de Copilot para personalizar o comportamento, impulsar a lóxica condicional ou recuperar información personalizada dos rexistros de Dataverse.

Obxecto de Windows

Clave Tipo Descrición
Iniciar Cadea O marcador de tempo de inicio desta xanela. Debe especificarse en UTC no formato yyyy-MM-ddTHH:mm:ss.fffZ .
Fin Cadea O marcador de tempo final desta fiestra. Debe especificarse en UTC no formato yyyy-MM-ddTHH:mm:ss.fffZ .

Solicitude de exemplo


{
  "ApiVersion": "1.0",
  "ProactiveEngagementConfigId": "cbbac510-3e66-ef11-a671-6045bd03d9d8",
  "DestinationPhoneNumber": "+123456798",
  "ContactId": "761e062f-c734-ef11-8e4f-00224808a166",
  "Windows": [
    {
      "Start": "2024-09-10T13:00:00.000Z",
      "End": "2024-09-10T15:59:59.999Z"
    },
    {
      "Start": "2024-09-11T13:00:00.000Z",
      "End": "2024-09-11T15:59:59.999Z"
    }
  ],
  "InputAttributes": {
    "orderNumber": "ORD123456789",
    "type": "callback",
    "isFinalAttempt": "false"
  }
}

Detalles da resposta

En caso de éxito, este método devolve.DeliveryId O ID de entrega é un identificador único asignado a cada solicitude de compromiso proactivo que se acepta a través da API e se almacena na táboa msdyn_proactive_delivery.

A resposta do exemplo é a seguinte:


{
	"@odata.context": "[Organization URI]api/data/v9.2/$metadata#Microsoft.Dynamics.CRM.CCaaS_CreateProactiveVoiceDeliveryResponse",
	"DeliveryId": "9838deee-0b4e-4116-bf73-ecb80474568d"
}

Planifica chamadas desde calquera plataforma

Podes usar a solución Proactive Engagement para programar chamadas de varias plataformas, incluíndo web, aplicacións móbiles, axentes de voz e chat. Pode realizar isto das seguintes maneiras:

  • Crea un fluxo de Power Automate desde o axente Copilot Studio.
  • Integra a API de chamada de planificación co teu sitio web.

Crea un fluxo de Power Automate desde o axente Copilot

Podes crear un fluxo de Power Automate desde o axente Copilot para programar chamadas. Realice os seguintes pasos:

  1. Siga os pasos en Crear un fluxo que pode usar cun axente cos seguintes parámetros:
  • Especifique Realizar unha acción non vinculada como acción.
  • Seleccione CCaaS_CreateProactiveVoiceDelivery como nome da acción.
  • En parámetros avanzados, especifique os seguintes campos obrigatorios:
    • Item/DestinationPhoneNumber: Número de teléfono do cliente para chamar.
    • Item/ProactiveEngagementConfigId: ID da configuración de compromiso proactivo a usar. Isto indica o tipo de modo de marcación, o fluxo de traballo e o perfil de saída a usar ao contactar co cliente. Podes copiar este ID da táboa de> de Power Apps >.
    • Elemento/APIversión: 1.0
    • Item/ContactId: ID do contacto do cliente en Dynamics CRM.
    • Opcionalmente, pode especificar Item/InputAttributes. Este campo debe conter un obxecto JSON que é usado polo axente Copilot. Por exemplo, { "msdyn_CaseTitle" : "Vitre cassée", "msdyn_CustomerName" : "Sarah", "msdyn_CustomerPhone" : "+1234567890", "msdyn_CustomerId" : "cfaa617b-2fc1-ef11-b8e8-000d3a5bcd16" }.

Usa a API para programar chamadas

Integra a CCaaS_CreateProactiveVoiceDelivery API co teu sitio web para permitir aos clientes solicitar asistencia nos momentos máis convenientes para eles.

Solicitude de mostra

{
  "ApiVersion": "1.0",
  "ProactiveEngagementConfigId": "cbbac510-3e66-ef11-a671-6045bd03d9d8",
  "DestinationPhoneNumber": "+123456798",
  "ContactId": "761e062f-c734-ef11-8e4f-00224808a166",
  "Windows": [
    {
      "Start": "2024-09-10T13:00:00.000Z",
      "End": "2024-09-10T15:59:59.999Z"
    },
    {
      "Start": "2024-09-11T13:00:00.000Z",
      "End": "2024-09-11T15:59:59.999Z"
    }
  ],
  "InputAttributes": {
     "type": "callback"
    "isLastAttempt": "false"
  }
}

Usar táboas de compromiso proactivo para informar