Activar una llamada de VoiceAgent desde Salesforce

​

Antes de empezar

• Un VoiceAgent de CloudTalk ya creado (anota el ID del VoiceAgent)
• Credenciales de la API de CloudTalk (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

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.

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.

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<Request> 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<String, Object>{
            '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.

​

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.

​

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.