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

# Automatizar tags de contactos

> Crie um fluxo de trabalho automatizado para adicionar tags a contactos que cumpram determinados critérios

<Note>
  Este artigo apresenta um exemplo de configuração das Automações de fluxo de trabalho da CloudTalk para adicionar automaticamente tags aos perfis de contacto quando determinados requisitos são cumpridos.
</Note>

**Nível de utilizador**: Admin

***

<h2 id="h_1516871ba6">
  Porque é que as tags são úteis
</h2>

As tags podem ser uma ferramenta útil para agrupar contactos em campanhas, reconhecer contactos provenientes de vários CRMs, gerir contactos e até [encaminhar contactos por diferentes Fluxos de chamadas](/pt/articles/5763009-caller-based-routing-with-conditions#h_d8706b26a3), recorrendo, por exemplo, a um Divisor de Condições no Call Flow Designer.

Para mais informações sobre a utilização de tags, consulte o nosso artigo dedicado às tags [aqui.](/pt/articles/5440393-contact-tags)

Se procura informações específicas sobre as Campanhas na CloudTalk, encontra-as [aqui.](/pt/articles/8428838-setting-up-campaigns-legacy-dialer)

<h2 id="h_1397798814">
  Configurar um fluxo de trabalho para automatizar a atribuição de tags a contactos
</h2>

As *Automações de fluxo de trabalho* são cenários automatizados que pode desenhar e que estão disponíveis no dashboard, através do separador **Conta**.

<h4 id="h_a6af840417">
  Caso de exemplo:
</h4>

A nossa empresa organiza frequentemente campanhas de chamadas para leads de chamadas de saída, mas adicionar manualmente tags para distinguir estes novos contactos de chamadas de saída atrasa o processo.

<h4 id="h_181d8ecedd">
  Objetivo:
</h4>

Reconhecer se ocorreu uma chamada de saída atendida e, em caso afirmativo, adicionar uma nova tag — `outbound_lead`.

<h3 id="h_66ba6e9141">
  Passos
</h3>

1. Antes de criar o fluxo de trabalho, é necessário gerar um conjunto único de chaves da API para utilizar mais tarde. No Dashboard, aceda a **Conta->Definições** e clique no cabeçalho *Chaves da API*. Se necessário, gere um par de chaves da API não utilizado através do botão **`+ Adicionar chave de API`**. Copie e cole estes valores num documento privado ou guarde-os de outra forma para os utilizar mais à frente no processo.

2. Em **Conta -> Automações de fluxo de trabalho** no [Dashboard](https://dashboard.cloudtalk.io/login), clique no botão azul **`+ Adicionar Fluxo de Trabalho`**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5846575/867eb714a08f-wfa.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=976d1d5b664f8fed422c95b839aa55e2" alt="" width="1698" height="1231" data-path="images/help-center/articles/5846575/867eb714a08f-wfa.png" />
   </Frame>

3. Dê um **Nome** descritivo ao fluxo de trabalho.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5846575/314fe19c072c-image.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=19876d066e3e057237a257b75f413d1b" alt="" width="1132" height="438" data-path="images/help-center/articles/5846575/314fe19c072c-image.png" />
   </Frame>

4. O primeiro passo de filtragem de qualquer fluxo de trabalho é o [Acionador](/pt/articles/5648924-triggers). Queremos que o objeto do Acionador seja uma **chamada** e, como ação do Acionador, escolhemos **terminada**. Esta combinação faz com que a nossa automação seja acionada quando uma chamada termina.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5846575/819f36cf6059-image.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=12af47c8cc7e82f0bf434e85e232d2fc" alt="" width="1650" height="452" data-path="images/help-center/articles/5846575/819f36cf6059-image.png" />
   </Frame>

5. O nosso objetivo neste exemplo exige também que definamos algumas [Condições](/pt/articles/5649346-conditions) adicionais. A automação não deve ser acionada sempre que uma chamada termina. Em primeiro lugar, não queremos incluir chamadas sem qualquer tempo de conversação, uma vez que corresponderiam a chamadas caídas. Defina este filtro criando uma Condição com um valor dinâmico. Clique na caixa **Propriedade**. Depois, na secção *Dados úteis para os seus fluxos de trabalho*, à direita, clique em **`talking_time`** para preencher a caixa com o valor dinâmico correspondente. A notação resultante deve corresponder à imagem abaixo. Como **Operando**, escolha **é maior que** e, como **Valor**, introduza `10` para compensar eventuais atrasos de ligação.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5846575/7c096f3d7f42-condition.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=4684453bc0565e17a122612f36834742" alt="" width="2496" height="1122" data-path="images/help-center/articles/5846575/7c096f3d7f42-condition.png" />
   </Frame>

   ```
   Esta Condição filtra as chamadas com um tempo de conversação superior
   a dez segundos. 
   ```

6. Deve ser adicionada outra Condição para filtrar apenas as chamadas de saída. **+ Adicionar Condição**. Preencha a caixa **Propriedade** como na condição anterior, desta vez com o valor dinâmico de **direction**. Como **Operando**, escolha **é igual a**, que procura uma correspondência exata de carateres. Escreva `outgoing` totalmente em minúsculas como **Valor**. Se não for necessário adicionar mais condições, podemos **`Confirmar e continuar`**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5846575/18d8998febd1-image.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=769ac30aa49d70bf52ea00ac268fa5a6" alt="" width="1636" height="1044" data-path="images/help-center/articles/5846575/18d8998febd1-image.png" />
   </Frame>

7. Existem três tipos de [Ação](/pt/articles/5649782-actions) à escolha. Para efeitos deste exemplo, vamos enviar informação de volta através da API da CloudTalk. Isto exige uma Ação **Pedido de API**.

8. A Ação **Pedido de API** foi concebida para ser flexível, pelo que exige que os utilizadores consultem documentação e recursos adicionais para formatar corretamente os cabeçalhos e os valores. Uma vez que este exemplo pretende fazer um pedido de API à API da CloudTalk, podemos consultar a [Referência da API da CloudTalk](/developers#section/API-Overview) para obter a formatação correta. Primeiro, é necessário introduzir um **Ponto Final.** Detalhando, o ponto final necessário vai incluir uma referência ao endereço web ou token ([`https://my.cloudtalk.io/api`](https://my.cloudtalk.io/api)), uma referência ao aspeto do endereço que pretendemos manipular (`contacts`), uma referência ao contacto em questão (`the contact id`), uma referência à função que queremos executar para esse contacto (`addTags`) e, por fim, um tipo de formato (`.json`). Seguindo a documentação da API ligada acima**,** o formato do nosso **Ponto Final** será**:**

   **[`https://my.cloudtalk.io/api/contacts/addTags/{contactId}.json`](https://my.cloudtalk.io/api/contacts/addTags/%7BcontactId%7D.json)**

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5846575/f840d80b4692-image.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=917debe682a94c2951262e46cdf48268" alt="" width="1562" height="570" data-path="images/help-center/articles/5846575/f840d80b4692-image.png" />
   </Frame>

   Como **Método**, escolhemos **PUT**, pedindo ao sistema que *coloque* nova informação na base de dados caso ainda não exista. Repare também que, na imagem, `contactId` está destacado porque tem de ser substituído por um valor dinâmico que permita à API referenciar o ID real de um determinado contacto.

9. A referência de valor dinâmico a inserir no lugar de `{contactId}` é a seguinte:

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

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5846575/3c78e640be1f-image.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=70ece113751595534df3f8c8f3949ed4" alt="" width="1562" height="570" data-path="images/help-center/articles/5846575/3c78e640be1f-image.png" />
   </Frame>

10. A maioria das chamadas à API exige alguma forma de autorização. É aqui que entram as Chaves da API obtidas na nossa página **Definições**. Devido à forma criativa como estamos a fazer um pedido através da própria API da CloudTalk, teremos de abrir um separador à parte e recorrer à ajuda de uma plataforma de API como o Workato, o SAP Integration ou a AWS para construir o formato corretamente codificado do nosso cabeçalho de autorização. A título de exemplo, abaixo está uma imagem do aspeto que pode ter a combinação do Access Key ID e do Access Key Secret, através da interface do Postman. As duas chaves são introduzidas como valores de autorização básica e o resultado será um cabeçalho formatado com uma Chave e um Valor em cadeia de carateres encriptada.

    <Frame>
      <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5846575/8c4d72e061a4-enter-keys-on-postman.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=cd5997e183ec68ccbda09cb415bcd780" alt="" width="1855" height="613" data-path="images/help-center/articles/5846575/8c4d72e061a4-enter-keys-on-postman.png" />
    </Frame>

    ```
    Nota: A navegação na página web e os nomes dos campos variam ligeiramente consoante a plataforma de API utilizada. 
    ```

    <Frame>
      <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5846575/7ce2eb17267c-example-value-postman.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=ee499f6629d400fc7d2c07823ca93c71" alt="" width="1347" height="353" data-path="images/help-center/articles/5846575/7ce2eb17267c-example-value-postman.png" />
    </Frame>

11. Assim que tivermos um par Chave:Valor no formato correto, introduzimos estas sequências nas caixas com os nomes correspondentes em *Cabeçalhos* no nosso Pedido de API da CloudTalk.

    <Frame>
      <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5846575/ef4d80e7f64c-image.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=11dcf1a66708b3006ac2c8f8c1771fe7" alt="" width="1562" height="512" data-path="images/help-center/articles/5846575/ef4d80e7f64c-image.png" />
    </Frame>

12. Na secção *Valores* do pedido, podemos definir o nome da tag que queremos adicionar quando a automação for acionada. Como **Chave**, introduza `tags.0` para referenciar a lista de tags. Introduza o nome de tag pretendido na caixa **Valor**.

    <Frame>
      <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5846575/275b074eb210-image.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=0bd70ac3d34711f35204c9b181a52787" alt="" width="1562" height="512" data-path="images/help-center/articles/5846575/275b074eb210-image.png" />
    </Frame>

13. Se não houver cabeçalhos ou valores adicionais a adicionar, podemos rever a nossa **Ação Pedido de API** e confirmar que todas as entradas dos campos estão no formato correto. Depois, **`Confirmar e continuar`**.

14. Depois de guardarmos a automação e a definirmos como *Ativo*, esta pode começar a funcionar. Nos casos em que as condições são cumpridas, a nossa tag `outbound_lead` é adicionada automaticamente aos perfis de contacto que ainda não tenham esta tag.

***

<h2 id="h_ae059d4dd2">
  Porque é que a minha automação não está a funcionar?
</h2>

Teste um cenário que deva acionar a automação e verifique o contador "execuções este mês" para obter informação.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5846575/dff205e852cd-wfa.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=18ea4131280a109230770fe612e10353" alt="" width="2048" height="252" data-path="images/help-center/articles/5846575/dff205e852cd-wfa.png" />
</Frame>

Consoante a contagem tenha subido ou descido depois de atualizar a página, verifique estes cenários comuns para ver se se aplicam à sua situação. Se o problema persistir, contacte a equipa de suporte da CloudTalk.

* ### A contagem de "execuções este mês" não sobe

  Isto significa que a automação não está a ser acionada, o que indica que as Condições definidas não estão a ser cumpridas. Certifique-se de que as Condições são lógicas e abrangem os eventos que devem acionar a automação.

* ### A contagem de "execuções este mês" sobe, mas a minha ação de API não acontece

  Isto resulta muito provavelmente de algo errado na estrutura da API no passo de Ação da automação. Verifique se:

  * o ponto final está formatado corretamente, tal como mostrado nos passos acima

  * são utilizados valores dinâmicos em vez de marcadores de formatação como "`ContactId`"

  * foi aplicado corretamente um cabeçalho de autorização

  * as cadeias de **Chave** na parte *Valores* do pedido estão escritas no [formato esperado pelo interpretador da API](/developers#tag/Tags/paths/~1tags~1index.json/get)

***

*Precisa de ajuda ou tem alguma questão?* Contacte-nos através do nosso [portal de Suporte](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — estamos aqui para si.


## Related topics

- [Utilizadores](/pt/articles/9241618-users.md)
- [Automatizar um SMS de boas-vindas](/pt/articles/8069738-automate-a-welcome-sms.md)
- [Automatizar um SMS de seguimento](/pt/articles/5645146-automate-a-follow-up-sms.md)


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