Activar una llamada de VoiceAgent desde HubSpot

​

Antes de empezar

• Un VoiceAgent de CloudTalk ya creado
• Credenciales de API de CloudTalk (Clave de API y Secret)
• Una cuenta de HubSpot con acceso a Workflows
• Propiedades de contacto que incluyan al menos un número de teléfono

​

Crear un activador de flujo de trabajo en HubSpot

1. Abre HubSpot > Workflows.
2. Crea un flujo de trabajo nuevo de tipo Contact-based.
3. Elige un tipo de activador, por ejemplo:
   • Property value changed
   • List membership changed
     (También se admiten campos personalizados.)
     
4. Opcional: activa Re-enrollment si quieres que se llame varias veces al mismo contacto cada vez que se cumplan las condiciones.
   

​

Añadir la acción de código personalizado

1. Haz clic en + Agregar acción
2. Selecciona Data ops > Custom code
3. Configura la acción:
   • Language: Node.js 20.x
   • Secrets: déjalo vacío
   • Properties to include in code:
     • phone (obligatorio)
     • Los campos adicionales que necesites, como name o contactId

​

Pegar el fragmento de código

const axios = require('axios');
exports.main = async (event, callback) => {
  const phone = event.inputFields['phone'];
  const name = event.inputFields['name'];
  const contactId = event.inputFields['contactId'];

  try {
    // Convert hs_object_id to integer
    const contactIDint = parseInt(contactId, 10);

    // Check if conversion was successful
    if (isNaN(contactIDint)) {
      throw new Error('Invalid hs_object_id: not a number');
    }

    // Prepare request body
    const data = {
      call_number: phone,
      voice_agent_id: "67eba86558ba995b89e05e08",
      call_properties: {
        system_prompt: {
          variables: {
            name: name
          }
        },
        output: {
          variables: {
            contactID: contactIDint
          }
        }
      }
    };

    // Send POST request
    const response = await axios.post('https://api.cloudtalk.io/v1/voice-agent/calls', data, {
      headers: {
        'Authorization': 'Basic #{{ Auth Header}}',
        'Content-Type': 'application/json'
      }
    });

    // Log success and return
    console.log('Call triggered successfully:', response.data);
    callback({
      outputFields: {
        status: 'Call triggered successfully'
      }
    });
  } catch (error) {
    console.error('Error triggering call:', error.message);
    callback({
      outputFields: {
        status: `Error: ${error.message}`
      }
    });
  }
};

• Envía una solicitud POST a la API de VoiceAgent de CloudTalk
• Envía el número de teléfono del contacto
• De forma opcional, envía variables como el nombre o el Record ID
• Recibe el resultado del VoiceAgent en el endpoint que hayas seleccionado en CloudTalk

​

Generar el encabezado de autorización

1. Ve a https://www.debugbear.com/basic-auth-header-generator
2. Introduce tu Clave de API de CloudTalk y tu Secret de API de CloudTalk
   (los encontrarás en la Configuración de la empresa de CloudTalk).
3. Copia el encabezado generado. Se parecerá a esto: Basic XXXXXXXXX

​

Publicar y probar el flujo de trabajo

1. Guarda el paso de código personalizado.
2. Haz clic en Review and publish.
3. Decide si el flujo de trabajo debe:
   • Ejecutarse solo para los contactos nuevos que cumplan las condiciones, o
   • Ejecutarse también para los contactos que ya las cumplen cuando se activa el flujo de trabajo.
4. Activa el flujo de trabajo actualizando una propiedad o la pertenencia a una lista de un contacto de prueba.

​

Comprobar el historial de inscripciones

1. Abre el flujo de trabajo
2. Ve a Performance history > Enrollment history
3. Busca tu contacto de prueba en la lista