> ## 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.

# Ações

> Saiba como utilizar uma Ação nas suas Automações de fluxo de trabalho

<Note>
  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).
</Note>

**Nível de utilizador:** Admin

***

<h2 id="h_2b27478f29">
  Configurar uma Ação
</h2>

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.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5649782/0b872f47cd70-image.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=b68d6d7c7933e8ecd1c8a901fe53270b" alt="" width="1588" height="294" data-path="images/help-center/articles/5649782/0b872f47cd70-image.png" />
</Frame>

A CloudTalk disponibiliza atualmente quatro tipos de ações:

* **[Pedido de API](#h_0267cfe306)**

* **[SMS](#h_1714226b93)**

* **[Enviar notificação para o Slack](#h_1710cb965a)**

* **Voz para Texto (apenas visível quando é utilizado o acionador *Gravação*)**

<Note>
  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.
</Note>

<h2 id="h_0267cfe306">
  Pedido de API
</h2>

<Warning>
  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](/guides/webhooks/overview) 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.
</Warning>

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](/developers) 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:

<table>
  <tbody>
    <tr>
      <td>
        "Nome"
      </td>

      <td>
        Definição
      </td>

      <td>
        Valor de exemplo
      </td>
    </tr>

    <tr>
      <td>
        **Ponto Final**
      </td>

      <td>
        *URL do respetivo ponto final da API*
      </td>

      <td>
        [`https://my.crmwebsite.com/api/contacts/index`](https://my.crmwebsite.com/api/contacts/index)
      </td>
    </tr>

    <tr>
      <td>
        **Método**
      </td>

      <td>
        *Define a ação do pedido de API*
      </td>

      <td>
        Aceites: `PUT`, `POST`, `PATCH`, `GET`, `DELETE`
      </td>
    </tr>

    <tr>
      <td>
        **Cabeçalhos**
      </td>

      <td>
        *Metadados, frequentemente necessários para autenticação e outros fins*
      </td>

      <td>
        Chave: `Autorização`\
        Valor: `Basic x1x2x3x4x5x6x789`
      </td>
    </tr>

    <tr>
      <td>
        **Valores**
      </td>

      <td>
        *Definem o corpo do pedido na forma de um objeto JSON*
      </td>

      <td>
        Chave: `contactName`

        Valor: `Johnny Snow`

        Formato: `String`
      </td>
    </tr>
  </tbody>
</table>

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:

```
contactName
```

O **Valor** pode ser *estático*. Pode ser algo como:

```
Johnny Snow
```

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:

```
#{{event.properties.contacts[0].name}}
```

<Frame>
  <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5649782/d2fb43651165-api-ref.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=45f397722e6dc9f680d6d5fd50eaf711" alt="" width="1996" height="792" data-path="images/help-center/articles/5649782/d2fb43651165-api-ref.png" />
</Frame>

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

<h2 id="h_1714226b93">
  SMS
</h2>

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](/developers#tag/Sms/paths/~1sms~1send.json/post), 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](/developers#section/API-Overview/Usage).

<Frame>
  <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5649782/8f6e29a0f474-image.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=22082be676499acccf008dbd4e51109e" alt="" width="1632" height="1022" data-path="images/help-center/articles/5649782/8f6e29a0f474-image.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5649782/54745a3951f9-image.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=e22b01ccc3974d5eb393c08aeb731faa" alt="" width="1632" height="1128" data-path="images/help-center/articles/5649782/54745a3951f9-image.png" />
</Frame>

<h4 id="h_ed9b4080e8">
  Problemas comuns
</h4>

* 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.

<h2 id="h_1710cb965a">
  Enviar notificação para o Slack
</h2>

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:

<Frame>
  <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5649782/f3b072d2646e-slack-result.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=0cb4ffc97c5d425a638e6915361164ab" alt="" width="697" height="454" data-path="images/help-center/articles/5649782/f3b072d2646e-slack-result.png" />
</Frame>

<h2 id="h_8f5fef5c11">
  Transcrição de Voz para Texto
</h2>

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](/pt/articles/5671571-speech-to-text-transcription) sobre a Transcrição de Voz para Texto para compreender melhor como esta funcionalidade funciona, as suas características e os custos associados.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5649782/f5c7880d5efa-image.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=854c2d7540c6b4020503a28f755307c0" alt="" width="1458" height="1310" data-path="images/help-center/articles/5649782/f5c7880d5efa-image.png" />
</Frame>

<h2 id="h_b4bcdfa5d9">
  Reutilizar o resultado de nós de Ação anteriores
</h2>

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

<h3 id="h_8f05ed7c5f">
  Como funciona
</h3>

Para acceder aos dados devolvidos por uma Ação de Pedido de API anterior, tem de utilizar o **formato exato**:

```
#{{ actionData.[actionIdentifier].message.[fieldName] }}
```

* `[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

<Warning>
  O prefixo `.message.` é **obrigatório** ao referenciar dados da resposta. Omiti-lo ou utilizar uma estrutura diferente resulta numa referência inválida.
</Warning>

*Exemplo*

Digamos que temos um nó de Ação de Pedido de API identificado como `CreateLead`

<Frame>
  <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5649782/9ea2ff3e154d-image.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=ed7fd12fe9cea1916099cea8ffe5ac95" alt="" width="1644" height="298" data-path="images/help-center/articles/5649782/9ea2ff3e154d-image.png" />
</Frame>

A ação de Pedido de API `CreateLead` devolve a seguinte resposta:

```json theme={"system"}
{
  "lead_id": "abc123",
  "status": "created"
}
```

Para referenciar o `lead_id` noutra Ação, utilize a referência:

```
#{{ actionData.CreateLead.message.lead_id }}
```

***

*Precisa de ajuda ou tem alguma dúvida?* Entre em contacto através do nosso [Portal de Suporte](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — estamos aqui para o ajudar.


## Related topics

- [Ações do Salesforce](/pt/articles/9394264-salesforce-actions.md)
- [Cenários e regras do VoiceAgent](/pt/articles/14073408-voiceagent-scenarios-guardrails.md)
- [Configurar o HubSpot](/pt/articles/3206271-configure-hubspot.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.