Uso de un punto de conexión HTTPS para administrar clientes potenciales de marketplace comercial

Si el sistema de administración de relaciones con clientes (CRM) no se admite explícitamente en el Centro de partners para recibir clientes potenciales de Azure Marketplace y Microsoft AppSource, puede usar un punto de conexión HTTPS en Power Automate para administrar estos clientes potenciales. Con un punto de conexión HTTPS, los clientes potenciales de marketplace comercial se pueden enviar como notificación por correo electrónico o pueden escribirse en un sistema CRM admitido por Power Automate.

En este artículo se explica cómo crear un nuevo flujo en Power Automate para generar la dirección URL de HTTP POST que usará para configurar clientes potenciales en el Centro de partners. También se incluyen los pasos para probar el flujo con Postman.

Nota:

El conector de Power Automate usado en estas instrucciones requiere una suscripción de pago de Power Automate. Asegúrese de que tiene una cuenta para ello antes de configurar este flujo.

Creación de un flujo con Power Automate

  1. Abra la página web de Power Automate. Seleccione Iniciar sesión. Si aún no tiene una cuenta, seleccione Regístrese gratis para crear una.

  2. Inicie sesión, seleccione Mis flujos y cambie el entorno de Microsoft (valor predeterminado) a su entorno de Dataverse (CRM).

    Shows how to sign in to 'My flows.'

  3. En + Nuevo,seleccione + Instant cloud flow (Flujo de nube instantáneo).

    Shows how to select My flows, followed by Instant cloud flow.

  4. Asigne un nombre al flujo y, en Elija cómo se desencadena este flujo, seleccione Cuando se reciba una solicitud HTTP.

    Shows how to build an automated flow window Skip button.

  5. Haga clic en el paso del flujo para expandirlo.

    Shows how to expand the flow step.

  6. Use uno de los métodos siguientes para configurar el esquema JSON del cuerpo de la solicitud:

    • Copie el esquema JSON en el cuadro de texto Esquema JSON de cuerpo de solicitud.
    • Seleccione Utilizar la carga útil de muestra para generar el esquema. En el cuadro de texto Escriba o pegue una carga JSON de ejemplo, pegue el ejemplo JSON. Seleccione Listo para crear el esquema.

    Esquema JSON

    {
      "$schema": "https://json-schema.org/draft-04/schema#",
      "definitions": {},
      "id": "http://example.com/example.json",
      "properties": {
        "ActionCode": {
          "id": "/properties/ActionCode",
          "type": "string"
        },
        "OfferTitle": {
          "id": "/properties/OfferTitle",
          "type": "string"
        },
        "LeadSource": {
          "id": "/properties/LeadSource",
          "type": "string"
        },
        "Description": {
          "id": "/properties/Description",
          "type": "string"
        },
        "UserDetails": {
          "id": "/properties/UserDetails",
          "properties": {
            "Company": {
              "id": "/properties/UserDetails/properties/Company",
              "type": "string"
            },
            "Country": {
              "id": "/properties/UserDetails/properties/Country",
              "type": "string"
            },
            "Email": {
              "id": "/properties/UserDetails/properties/Email",
              "type": "string"
            },
            "FirstName": {
              "id": "/properties/UserDetails/properties/FirstName",
              "type": "string"
            },
            "LastName": {
              "id": "/properties/UserDetails/properties/LastName",
              "type": "string"
            },
            "Phone": {
              "id": "/properties/UserDetails/properties/Phone",
              "type": "string"
            },
            "Title": {
              "id": "/properties/UserDetails/properties/Title",
              "type": "string"
            }
          },
          "type": "object"
        }
      },
      "type": "object"
    }
    

    Ejemplo JSON

    {
      "UserDetails": {
        "FirstName": "Some",
        "LastName": "One",
        "Email": "someone@contoso.com",
        "Phone": "16175555555",
        "Country": "USA",
        "Company": "Contoso",
        "Title": "Esquire"
     },
      "LeadSource": "AzureMarketplace",
      "ActionCode": "INS",
      "OfferTitle": "Test Microsoft",
      "Description": "Test run through Power Automate"
    }
    

Nota:

En este punto de la configuración, puede seleccionar conectarse a un sistema CRM o configurar una notificación por correo electrónico. Siga las instrucciones restantes en función de su elección.

Conexión a un sistema CRM

  1. Seleccione + New step(+ Nuevo paso).

  2. Busque y seleccione un sistema CRM en el cuadro Buscar todos los conectores y acciones. La siguiente pantalla muestra Crear un nuevo registro (Microsoft Dataverse) como ejemplo.

    Shows how to create a new record.

  3. Seleccione la pestaña Acciones con la acción para Agregar una nueva fila.

    Shows how to select 'Create a new record.'

  4. Seleccione cliente potencial en la lista desplegable Nombre de la tabla.

    Shows how to select leads.

  5. Power Automate muestra un formulario para proporcionar información sobre clientes potenciales. Puede asignar elementos de la solicitud de entrada y elige agregar contenido dinámico. La pantalla siguiente muestra OfferTitle como ejemplo.

    Shows how to add dynamic content.

  6. Asigne los campos que quiera y seleccione Guardar para guardar el flujo. Se crea una dirección URL de HTTP POST, y se puede acceder a ella en la ventana Cuando se recibe una solicitud HTTP. Copie esta dirección URL mediante el control de copia, que se encuentra a la derecha de la dirección URL de HTTP POST. Es importante utilizar el control de copia para no omitir ninguna parte de la dirección URL completa. Guarde esta dirección URL, ya que la necesitará al configurar la administración de clientes potenciales en el portal de publicación.

    Shows when an HTTP request is received.

Configuración de notificaciones de correo electrónico

  1. Ahora que ha completado el esquema JSON, seleccione + Nuevo paso.

  2. En Elegir una acción, seleccione Acciones.

  3. En la pestaña Acciones, seleccione Enviar un correo electrónico (Office 365 Outlook).

    Nota:

    Si desea usar otro proveedor de correo electrónico, busque y seleccione Enviarme una notificación por correo electrónico (Correo) como acción en su lugar.

    Add an email action

  4. En la ventana Enviar un correo electrónico, configure los siguientes campos obligatorios:

    • Para: escriba al menos una dirección de correo electrónico válida donde se enviarán los clientes potenciales.
    • Asunto: Power Automate le ofrece la opción de agregar contenido dinámico, como LeadSource que se muestra en la pantalla siguiente. Empiece por escribir un nombre de campo. A continuación, seleccione la lista de selección de contenido dinámico en la ventana emergente.

    Nota:

    Al agregar nombres de campo, puede agregar dos puntos (:) después de cada nombre y seleccionar Entrar para crear una nueva fila. Una vez que haya agregado los nombres de campos, puede agregar cada parámetro asociado desde la lista desplegable dinámica.

    Add an email action by using dynamic content

    • Cuerpo: en la lista de selección de contenido dinámico, agregue la información que desee en el cuerpo del correo electrónico. Por ejemplo, nombre, apellidos, correo electrónico y empresa. Cuando haya terminado de configurar la notificación por correo electrónico, tendrá un aspecto similar al ejemplo de la siguiente pantalla.

    Email notification example

  5. Seleccione Guardar para finalizar el flujo. Se crea una dirección URL de HTTP POST, y se puede acceder a ella en la ventana Cuando se recibe una solicitud HTTP. Copie esta dirección URL mediante el control de copia, que se encuentra a la derecha de la dirección URL de HTTP POST. Es importante utilizar este control para no omitir ninguna parte de la dirección URL completa. Guarde esta dirección URL, ya que la necesitará al configurar la administración de clientes potenciales en el portal de publicación.

    HTTP POST URL

Prueba

Puede probar la configuración con Postman. Hay disponible una descarga en línea de Postman para Windows.

  1. Inicie Postman y seleccione Nuevo>Solicitud para configurar la herramienta de prueba.

    Request to set up your test tool

  2. Rellene el formulario Guardar solicitud y, luego, guárdelo en la carpeta que ha creado.

    Save Request form

  3. Seleccione POST en la lista desplegable.

    Test my flow

  4. Pegue la dirección URL de HTTP POST del flujo que creó en Power Automate, donde dice Escribir la dirección URL de la solicitud.

    Paste the HTTP POST URL

  5. Regrese a Power Automate. Busque el flujo que creó para enviar clientes potenciales; para ello, vaya a Mis flujos en la barra de menús de Power Automate. Seleccione los puntos suspensivos junto al nombre del flujo para ver más opciones y elija Editar.

  6. Seleccione Probar en la esquina superior derecha, elija Yo realizaré la acción de desencadenamiento y luego seleccione Probar. Verá una indicación en la parte superior de la pantalla que indica que se ha iniciado la prueba.

    I'll perform the trigger action option

  7. Vuelva a la aplicación Postman y seleccione Enviar.

    Send button

  8. Vuelva al flujo y compruebe el resultado. Si todo funciona según lo previsto, verá un mensaje que indica que el flujo se ha realizado correctamente.

    Check results

  9. También debería haber recibido un correo electrónico. Compruebe la bandeja de entrada del correo.

    Nota:

    Si no ve un correo electrónico de la prueba, compruebe las carpetas de correo no deseado y spam. En la siguiente pantalla, observará solo las etiquetas de campo que agregó al configurar la notificación por correo electrónico. Si se tratase de un cliente potencial real generado a partir de su oferta, también vería la información real del contacto de cliente potencial en el cuerpo y en la línea de asunto.

    Email received

Configuración de la oferta para enviar clientes potenciales al punto de conexión HTTPS

Cuando esté listo para configurar la información de administración de clientes potenciales de la oferta en el portal de publicación, siga estos pasos:

  1. Inicie sesión en el Centro de partners.

  2. Seleccione la oferta y vaya a la pestaña Configuración de la oferta.

  3. En la sección Clientes potenciales, seleccione Conectar.

    Customer leads

  4. En la ventana emergente Detalles de conexión, seleccione Punto de conexión HTTPS como Destino de clientes potenciales. Pegue la dirección URL de HTTP POST del flujo que creó siguiendo los pasos anteriores en el campo Dirección URL del punto de conexión HTTPS. Connection details Contact email.

  5. Seleccione Aceptar.

Para asegurarse de que se ha conectado correctamente a un destino de clientes potenciales, seleccione el botón Validar. Si la validación es correcta, tendrá un cliente potencial de prueba en el destino de clientes potenciales.

Nota:

Debe terminar de configurar el resto de las partes de la oferta y publicarla para poder recibir clientes potenciales para la oferta.

Cuando se generan clientes potenciales, Microsoft envía los clientes potenciales al flujo. Los clientes potenciales se dirigen a la dirección de correo electrónico o al sistema CRM que ha configurado.