Acionar uma chamada do VoiceAgent a partir do Salesforce

​

Antes de começar

• Um VoiceAgent da CloudTalk já criado (tome nota do ID do VoiceAgent)
• Credenciais da API da CloudTalk (Chave da API e Segredo)
• Salesforce Enterprise edition ou superior (Flow Builder com HTTP Callout)
• Um campo de telefone disponível nos seus registos Contact ou Lead, no formato E.164 (por exemplo, +14155550100)

​

Configurar a integração

​

Criar a Named Credential

1. Aceda a Setup > Security > Named Credentials > External Credentials.
2. Clique em New External Credential:
   • Label: CloudTalk API
   • Name: CloudTalk_API
   • Authentication Protocol: Basic
   
3. Clique em Save e, em Principals, clique em New:
   • Escolha um nome e defina o Identity Type como Named Principal.
   • Introduza o ID da Chave da API da CloudTalk como nome de utilizador e o Segredo da API como palavra-passe.
   • Clique em Save.

1. Aceda a Setup > Security > Named Credentials > Named Credentials.
2. Clique em New Named Credential:
   • Label: CloudTalk
   • Name: CloudTalk
   • URL: https://api.cloudtalk.io
   • External Credential: CloudTalk API
   • Em Callout Options, ative Generate Authorization Header e Allow Formulas in HTTP Body.
3. Clique em Save.

1. Aceda a Setup > Permission Sets, abra (ou crie) um permission set atribuído a si, vá a External Credential Principal Access > Edit, adicione o seu principal CloudTalk_API e clique em Save.

​

Criar a classe Apex

1. Aceda a Setup > Apex Classes > New.
2. Cole o código abaixo, substitua YOUR_VOICE_AGENT_ID na linha 3 pelo ID do seu VoiceAgent e clique em 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;
    }
}

​

Construir o Flow

1. Aceda a Setup > Process Automation > Flows > New Flow.
2. Selecione Record-Triggered Flow.
3. Configure o acionador (Object: Contact ou Lead; When: um registo é criado ou um campo é alterado).
4. Adicione uma condição para filtrar registos, por exemplo, apenas quando o campo de telefone não estiver vazio.
5. Clique em + > Action e procure «Start CloudTalk Voice Agent Call».
6. Defina o valor de entrada de Call Number como {!$Record.Phone}.
7. Clique em Save e em Activate para ativar o Flow.

​

Testar e verificar

1. Crie ou atualize um registo que cumpra as condições do seu acionador.
2. Consulte Setup > Debug Logs ou os detalhes do Flow interview para confirmar a execução.
3. Confirme na CloudTalk que a chamada do VoiceAgent foi iniciada.

​

Resolução de problemas

• Callout não autorizado: certifique-se de que api.cloudtalk.io está adicionado em Remote Site Settings.
• 401 Unauthorized: verifique as credenciais guardadas no principal da External Credential.
• 400 Bad Request: confirme que o número de telefone está no formato E.164 (por exemplo, +14155550100).
• O Flow não é acionado: confirme que o registo cumpre todas as condições de entrada e que o Flow está ativo.