Tutorial: Crear un flujo de trabajo con HubSpot como fuente

Un ejemplo práctico del uso de la API para desarrolladores de Portant para crear un flujo de trabajo con HubSpot como fuente. Todas las solicitudes utilizan cURL. Reemplace <DEVELOPER_ACCESS_TOKEN> por el token que el equipo de integraciones de Portant le proporcionó.

Consejo: antes de comenzar, cree y ejecute un flujo de trabajo en la aplicación web Portant Workflow para familiarizarse con el funcionamiento de los flujos de trabajo. Se recomienda usar una plantilla de Google Docs, lo que también confirma que su cuenta está correctamente autorizada con las APIs de Google.

Este tutorial asume que ha completado los pasos de la guía Descripción general para desarrolladores y que su cuenta de Portant ya está conectada a HubSpot.

Paso 1. Crear un flujo de trabajo

Nombraremos el flujo de trabajo "Developer Workflow" y lo crearemos con el endpoint Workflows POST, pasando una fuente de HubSpot.

curl --location --request POST 'https://api.portant.co/v0/workflows/' \
--header 'Authorization: <DEVELOPER_ACCESS_TOKEN>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Developer Workflow",
    "source": {
        "sourceType": "HUBSPOT",
        "hubspotObjectTypeId": "0-3",
        "hubspotProperties": ["0-3.dealname", "0-1.firstname"]
    }
}'

Una fuente de HubSpot requiere dos campos adicionales junto a sourceType:

hubspotObjectTypeId (String) El tipo de objeto principal de HubSpot para este flujo de trabajo. Utiliza la convención de ID de tipo de objeto propia de HubSpot: 0-3, por ejemplo, es el ID de tipo de objeto para Deals (negocios). Consulte la referencia de ID de tipo de objeto de HubSpot para obtener la lista completa.

hubspotProperties (Array<String>) Las propiedades que se incluirán como campos fuente para este flujo de trabajo, cada una en el formato <objectTypeId>.<internalFieldName>, donde objectTypeId es el ID de tipo indicado anteriormente e internalFieldName es el nombre interno de esa propiedad en HubSpot. En el ejemplo anterior, 0-3.dealname obtiene el nombre del negocio y 0-1.firstname obtiene el nombre del contacto asociado.

Una solicitud exitosa devuelve 201 Created con el nuevo flujo de trabajo. Guarde el valor id, ya que lo utilizará para agregar una plantilla a continuación.

Paso 2. Agregar una plantilla y publicar el flujo de trabajo

A partir de aquí, el flujo de trabajo se comporta como cualquier otro. Los pasos restantes son idénticos a los del tutorial de Webhook:

• Crear un documento de plantilla para agregar el archivo que se combinará.
• Escuchar eventos de automatización para recibir notificaciones cuando se creen documentos.

Una vez que el flujo de trabajo tenga tanto una fuente de HubSpot como al menos una plantilla, su status pasa a ser "COMPLETE" y se ejecuta cada vez que un objeto de HubSpot coincidente lo activa.

Para obtener detalles sobre cada endpoint y recurso, consulte el resto de la referencia de la API. Si tiene preguntas o solicitudes de funciones, póngase en contacto con el equipo de éxito del cliente o de integraciones.