> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Activar una llamada de VoiceAgent desde HubSpot
> Automatiza las llamadas de VoiceAgent desde HubSpot
Puedes activar automáticamente una llamada de VoiceAgent de CloudTalk mediante los Workflows de HubSpot. En esta guía te explicamos cómo configurar el activador, enviar los datos del contacto a CloudTalk y consultar los resultados de inscripción en HubSpot.
**Nivel de usuario**: Agente
***
Antes de empezar
Necesitarás:
* 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
Después de configurar el activador:
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`
Estas propiedades se convierten en `event.inputFields[...]` dentro del script.
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}`
}
});
}
};
```
**Este script**:
* 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
CloudTalk utiliza autenticación básica para las solicitudes de API.\
Para generar tu valor codificado:
1. Ve a **[https://www.debugbear.com/basic-auth-header-generator](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`
Sustituye `#{{ Auth Header }}` en el script por este valor.
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
Para confirmar que se ha activado tu llamada de VoiceAgent:
1. Abre el flujo de trabajo
2. Ve a **Performance history > Enrollment history**
3. Busca tu contacto de prueba en la lista
Si todo ha funcionado, verás el contacto inscrito y la acción **Call triggered successfully**.
**¡Todo listo!**
A partir de ahora, tu flujo de trabajo de HubSpot activará automáticamente una llamada de VoiceAgent de CloudTalk cada vez que un contacto cumpla las condiciones que hayas elegido.
***
*¿Necesitas ayuda o tienes alguna pregunta?* Escríbenos a través de nuestro [Portal de atención al cliente](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) : estamos aquí para ayudarte.
## Related topics
- [Activar una llamada de VoiceAgent desde Salesforce](/es/articles/16064425-triggering-a-voiceagent-call-from-salesforce.md)
- [Activar una llamada de VoiceAgent desde Pipedrive](/es/articles/15516233-triggering-a-voiceagent-call-from-pipedrive.md)
- [Activar una llamada de VoiceAgent desde Freshservice](/es/articles/15502021-triggering-a-voiceagent-call-from-freshservice.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.