> ## 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 Salesforce
> Activa llamadas de VoiceAgent de CloudTalk directamente desde Salesforce mediante Flow Builder y una llamada HTTP de Apex
Puedes activar automáticamente una llamada de VoiceAgent de CloudTalk desde Salesforce usando Flow Builder con un HTTP Callout, respaldado por una clase de Apex. Esta guía te muestra cómo configurar la conexión, añadir la acción de llamada y confirmar que la llamada se ha iniciado.
**Nivel de usuario:** Admin
***
Antes de empezar
Necesitarás:
* Un VoiceAgent de CloudTalk ya creado (anota el ID del VoiceAgent)
* [Credenciales de la API de CloudTalk](/es/articles/15272380-how-to-access-and-generate-your-cloudtalk-api-keys) (Clave de API y secreto)
* Salesforce Enterprise edition o superior (Flow Builder con HTTP Callout)
* Un campo de teléfono disponible en tus registros de Contact o Lead, en formato `E.164` (por ejemplo, `+14155550100`)
Configurar la integración
Crear la Named Credential
Primero, crea una External Credential para guardar de forma segura tu clave de API de CloudTalk:
1. Ve a **Setup > Security > Named Credentials > External Credentials**.
2. Haz clic en **New External Credential**:
* **Label:** CloudTalk API
* **Name:** CloudTalk\_API
* **Authentication Protocol:** Basic
3. Haz clic en **Save** y, en **Principals**, haz clic en **New**:
* Elige un nombre y establece **Identity Type** en **Named Principal**.
* Introduce tu **API Key ID** de CloudTalk como nombre de usuario y el **API Secret** como contraseña.
* Haz clic en **Save**.
A continuación, crea la Named Credential que apunta a CloudTalk:
1. Ve a **Setup > Security > Named Credentials > Named Credentials**.
2. Haz clic en **New Named Credential**:
* **Label:** CloudTalk
* **Name:** CloudTalk
* **URL:** `https://api.cloudtalk.io`
* **External Credential:** CloudTalk API
* En **Callout Options**, activa **Generate Authorization Header** y **Allow Formulas in HTTP Body**.
3. Haz clic en **Save**.
Por último, concédete acceso a la credencial:
1. Ve a **Setup > Permission Sets**, abre (o crea) un conjunto de permisos asignado a ti, luego ve a **External Credential Principal Access > Edit**, añade tu principal `CloudTalk_API` y haz clic en **Save**.
Crear la clase de Apex
1. Ve a **Setup > Apex Classes > New**.
2. Pega el código de abajo, sustituye `YOUR_VOICE_AGENT_ID` en la línea 3 por el ID de tu VoiceAgent y haz clic en **Save**.
```
public with sharing class CloudTalkVoiceAgent {
private static final String VOICE_AGENT_ID = 'YOUR_VOICE_AGENT_ID';
@InvocableMethod(label='Start CloudTalk Voice Agent Call' description='Triggers a CloudTalk voice agent call')
public static void invoke(List requests) {
for (Request r : requests) {
startCall(r.callNumber);
}
}
@future(callout=true)
public static void startCall(String callNumber) {
HttpRequest req = new HttpRequest();
req.setEndpoint('callout:CloudTalk/v1/voice-agent/calls');
req.setMethod('POST');
req.setHeader('Content-Type', 'application/json');
req.setBody(JSON.serialize(new Map{
'call_number' => callNumber,
'voice_agent_id' => VOICE_AGENT_ID
}));
HttpResponse res = new Http().send(req);
System.debug('CloudTalk status: ' + res.getStatusCode());
}
public class Request {
@InvocableVariable(label='Call Number' required=true)
public String callNumber;
}
}
```
Crear el Flow
1. Ve a **Setup > Process Automation > Flows > New Flow**.
2. Selecciona **Record-Triggered Flow**.
3. Configura el activador (Object: Contact o Lead; When: se crea un registro o cambia un campo).
4. Añade una condición para filtrar registros, por ejemplo, solo cuando el campo de teléfono no esté vacío.
5. Haz clic en **+ > Action** y busca «Start CloudTalk Voice Agent Call».
6. Asigna al valor de entrada **Call Number** el valor `{!$Record.Phone}`.
7. Haz clic en **Save** y **Activate** el Flow.
`call_number` y `voice_agent_id` son los únicos campos obligatorios. De forma opcional, puedes añadir `call_properties`, como variables del prompt del sistema (datos que el VoiceAgent utiliza durante la llamada) y variables de salida (datos que se devuelven a tu endpoint después de la llamada), según la configuración de tu VoiceAgent. [Descubre qué incluir](/es/articles/11401649-voiceagents-for-outbound-calls).
Probar y verificar
1. Crea o actualiza un registro que cumpla tus condiciones de activación.
2. Consulta **Setup > Debug Logs** o los detalles de la interview del Flow para ver la ejecución.
3. Confirma en CloudTalk que la llamada del VoiceAgent se ha iniciado.
**¡Ya está todo listo!** 🚀 Tu Flow de Salesforce activará ahora automáticamente una llamada de VoiceAgent de CloudTalk cada vez que un registro cumpla las condiciones que hayas elegido.
Solución de problemas
* **Unauthorized callout:** asegúrate de que `api.cloudtalk.io` está añadido en Remote Site Settings.
* **401 Unauthorized:** verifica las credenciales guardadas en el principal de la External Credential.
* **400 Bad Request:** confirma que el número de teléfono está en formato E.164 (por ejemplo, `+14155550100`).
* **El Flow no se activa:** confirma que el registro cumple todas las condiciones de entrada y que el Flow está activo.
***
¿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 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)
- [Activar una llamada de VoiceAgent desde Zendesk](/es/articles/15934846-triggering-a-voiceagent-call-from-zendesk.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.