Skip to main content
As Automações de fluxo de trabalho foram concebidas para facilitar o trabalho do agente, automatizando processos como o envio de uma mensagem de seguimento, a transcrição de determinadas chamadas ou o encaminhamento automático de transcrições para o Slack. O tipo de passo que garante a execução destas ações chama-se Ação (não confundir com a Ação de Objeto selecionada no Acionador).
Nível de utilizador: Admin

Configurar uma Ação

Na Automação de fluxo de trabalho, um passo de Ação é o ponto onde uma tarefa específica é executada automaticamente. Quando as condições anteriores a este passo são cumpridas, a ação é acionada. É aqui que o sistema executa ações com base na sua configuração. Um passo de Ação de uma automação de fluxo de trabalho pode ser adicionado ao fluxo de trabalho em qualquer ponto após o Acionador. Basta selecionar a opção + Adicionar ação ao configurar um novo passo no fluxo de trabalho.
A CloudTalk disponibiliza atualmente quatro tipos de ações:
Cada fluxo de trabalho de automação necessita de, pelo menos, uma ação para funcionar como esperado. Pode adicionar várias ações no mesmo fluxo de trabalho para tornar a sua automação ainda mais eficiente.

Pedido de API

Só precisa de notificar o seu próprio sistema quando acontece algo na CloudTalk, como o fim de uma chamada ou a alteração de um contacto? Utilize os Webhooks em vez disso. Os Webhooks foram criados para uma entrega fiável de eventos, com payloads assinados, novas tentativas automáticas e reenvio e recuperação durante 30 dias. As ações de Pedido de API utilizam um caminho de entrega separado, que não os inclui.
Este tipo de Ação é indicado para utilizadores com conhecimentos técnicos que procuram mais liberdade criativa na conceção de automações. Uma API (Application Programming Interface) permite que diferentes aplicações web comuniquem entre si. Neste momento, os pedidos podem ser feitos à API REST da CloudTalk ou a outros sistemas externos que utilizem:
  • Esquemas de autenticação que requerem cabeçalhos estáticos e imutáveis (por exemplo, esquemas de autenticação Basic ou Bearer)
  • Sistemas com autenticação por URL / corpo JSON.
A API da CloudTalk é um exemplo deste último tipo. Cada Ação de API é composta pelos seguintes componentes:
“Nome”DefiniçãoValor de exemplo
Ponto FinalURL do respetivo ponto final da APIhttps://my.crmwebsite.com/api/contacts/index
MétodoDefine a ação do pedido de APIAceites: PUT, POST, PATCH, GET, DELETE
CabeçalhosMetadados, frequentemente necessários para autenticação e outros finsChave: Autorização
Valor: Basic x1x2x3x4x5x6x789
ValoresDefinem o corpo do pedido na forma de um objeto JSONChave: contactNameValor: Johnny SnowFormato: String
Utilize a secção Valores do construtor de pedidos de API para definir o corpo de um pedido. Cada entrada na secção Valores contém uma Chave, um Valor, e um Formato. Neste caso, a Chave é o nome da propriedade no pedido de API. Por exemplo:
O Valor pode ser estático. Pode ser algo como:
Este valor também pode ser uma propriedade dinâmica que envia o valor introduzido com base nos dados obtidos do Acionador escolhido. Para obter um valor dinâmico, escolha uma das frases azuis na barra lateral Dados úteis para o seu fluxo de trabalho. Como mostrado abaixo, a caixa Valor deverá ser preenchida com algo como:
Este exemplo obteria o valor name do contacto associado ao seu Acionador. O valor Formato descreve um tipo de dados, para que o sistema de destino (API) possa interpretar corretamente os dados incluídos. A CloudTalk suporta os seguintes formatos:
  • Número - inteiros (integers) ou decimais (floats com ponto como separador decimal)
  • String - sequência de caracteres alfanuméricos
  • Boolean - assume o valor True ou False (qualquer forma não definida assume False por predefinição)
  • Automaticamente - o tipo é detetado automaticamente

SMS

O passo de Ação SMS garante que é enviado um SMS para o número especificado como parte da automação. Em segundo plano, o sistema envia um pedido de API com os detalhes configurados para o ponto final da API Send SMS da CloudTalk, acionando o envio do SMS sem necessidade de intervenção do agente. Para configurar a Ação SMS, é necessário definir os seguintes atributos:
  • Destinatário - número de telefone, em formato internacional, para o qual o SMS deve ser enviado
  • Remetente - número de telefone com capacidade de SMS, em formato internacional, a partir do qual o SMS deve ser enviado
  • Texto - conteúdo da mensagem a enviar
  • Chave de API e API Secret - credenciais de API obtidas no Dashboard da CloudTalk pelo administrador
Como esta ação envolve um pedido à API da CloudTalk, aplicam-se os limites de taxa padrão. Para mais detalhes, consulte a nossa Documentação da API.

Problemas comuns

  • Os números nos campos Destinatário e Remetente têm de estar em formato internacional.
  • O número utilizado como Remetente tem de ter capacidade de SMS.
  • As credenciais de API têm de ser introduzidas sem espaços adicionais.
  • Certifique-se de que existe crédito suficiente na conta, uma vez que a automação de SMS implica custos adicionais.

Enviar notificação para o Slack

Este tipo de Ação é habitualmente utilizado para notificações internas, permitindo encaminhar informações importantes para um canal do Slack da empresa. Para utilizar esta opção, certifique-se de que tem uma ligação ao workspace e ao canal do Slack adequados. Além disso, verifique se os âmbitos do token do workspace e do canal incluem permissões chat:write. Para configurar a ação Enviar notificação para o Slack, é necessário definir os seguintes atributos:
  • Token: um token de autenticação gerado através da interface do Slack.
  • Canal: o canal do Slack onde as mensagens serão publicadas.
  • Texto: o conteúdo da mensagem.
  • Icon_emoji: um ícone emoji para representar a mensagem.
  • Icon_url: um URL de um ícone personalizado para representar a mensagem.
  • Use_markdown: quando definido como True, o texto é apresentado como texto formatado.
Tal como nos pedidos de API, o valor de cada parâmetro pode ser definido como uma entrada estática ou um valor dinâmico. Para utilizar um valor dinâmico, clique na caixa Valor e selecione uma das frases azuis na barra lateral Dados úteis para o seu fluxo de trabalho. A notificação do Slack resultante poderá ter um aspeto semelhante a este:

Transcrição de Voz para Texto

Este tipo de Ação é habitualmente utilizado para transcrever em texto escrito as conversas gravadas durante uma chamada. Tenha em conta que esta Ação só está disponível quando o Acionador Gravação Carregada está selecionado. Para configurar a ação Voz para Texto, é necessário definir os seguintes atributos:
  • Idioma
  • Transcrição Melhorada
  • Modelo
Saiba mais sobre a Transcrição de Voz para Texto para compreender melhor como esta funcionalidade funciona, as suas características e os custos associados.

Reutilizar o resultado de nós de Ação anteriores

Pode referenciar dinamicamente a resposta de um passo de Ação de Pedido de API anterior em passos subsequentes do seu fluxo de trabalho.

Como funciona

Para acceder aos dados devolvidos por uma Ação de Pedido de API anterior, tem de utilizar o formato exato:
  • [actionIdentifier] é o identificador único do nó de Ação, atribuído no momento em que é adicionado (por exemplo, um identificador gerado pelo sistema como 28547585 ou um nome personalizado como SendToCRM)
  • message representa o corpo da resposta, que deve ser um objeto JSON
  • [fieldName] é qualquer campo desse objeto JSON
O prefixo .message. é obrigatório ao referenciar dados da resposta. Omiti-lo ou utilizar uma estrutura diferente resulta numa referência inválida.
Exemplo Digamos que temos um nó de Ação de Pedido de API identificado como CreateLead
A ação de Pedido de API CreateLead devolve a seguinte resposta:
Para referenciar o lead_id noutra Ação, utilize a referência:

Precisa de ajuda ou tem alguma dúvida? Entre em contacto através do nosso Portal de Suporte — estamos aqui para o ajudar.