Acionar uma chamada do VoiceAgent a partir do HubSpot

​

Antes de começar

• Um VoiceAgent da CloudTalk já criado
• Credenciais da API da CloudTalk (Chave da API e Secret)
• Uma conta HubSpot com acesso a Workflows
• Propriedades de contacto que incluam, pelo menos, um número de telefone

​

Criar um acionador de workflow no HubSpot

1. Abra HubSpot > Workflows.
2. Crie um novo workflow Contact-based.
3. Escolha um tipo de acionador, por exemplo:
   • Property value changed
   • List membership changed
     (Também são suportados campos personalizados.)
     
4. Opcional: Ative Re-enrollment se quiser que o mesmo contacto seja chamado várias vezes sempre que as condições forem cumpridas.
   

​

Adicionar a ação Custom code

1. Clique em + Adicionar ação
2. Selecione Data ops > Custom code
3. Configure a ação:
   • Language: Node.js 20.x
   • Secrets: Deixe vazio
   • Properties to include in code:
     • phone (obrigatório)
     • Campos adicionais conforme necessário, como name ou contactId

​

Colar o excerto 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}`
      }
    });
  }
};

• Envia um pedido POST para a API do VoiceAgent da CloudTalk
• Transmite o número de telefone do contacto
• Opcionalmente, transmite variáveis como o nome próprio ou o Record ID
• Recebe o resultado do VoiceAgent no endpoint selecionado na CloudTalk

​

Gerar o cabeçalho de autorização

1. Aceda a https://www.debugbear.com/basic-auth-header-generator
2. Introduza a sua Chave da API da CloudTalk e o Secret da API da CloudTalk
   (disponíveis nas Definições da empresa da CloudTalk).
3. Copie o cabeçalho gerado. Será semelhante a: Basic XXXXXXXXX

​

Publicar e testar o workflow

1. Guarde o passo de código personalizado.
2. Clique em Review and publish.
3. Decida se o workflow deve:
   • Ser executado apenas para novos contactos que cumpram as condições, ou
   • Ser executado também para os contactos que já as cumprem no momento em que o workflow é ativado.
4. Acione o workflow atualizando uma propriedade ou a pertença a uma lista de um contacto de teste.

​

Verificar o Enrollment history

1. Abra o workflow
2. Aceda a Performance history > Enrollment history
3. Encontre o contacto de teste na lista