> ## 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 las etiquetas de contacto

> Crea un flujo de trabajo automatizado para añadir etiquetas a los contactos que cumplan determinados criterios

<Note>
  Este artículo muestra un ejemplo de configuración de las Automatizaciones de flujo de trabajo de CloudTalk para añadir etiquetas automáticamente a los perfiles de contacto cuando se cumplen ciertas especificaciones.
</Note>

**Nivel de usuario**: Admin

***

<h2 id="h_1516871ba6">
  Por qué son útiles las etiquetas
</h2>

Las etiquetas son una herramienta muy práctica para agrupar contactos en campañas, reconocer contactos procedentes de distintos CRM, gestionar contactos e incluso [enrutar contactos por diferentes Flujos de llamadas](/es/articles/5763009-caller-based-routing-with-conditions#h_d8706b26a3) con ayuda de elementos como el Divisor de condición en el Diseñador de Flujo de Llamadas.

Para más información sobre el uso de las etiquetas, consulta nuestro artículo dedicado a las etiquetas [aquí.](/es/articles/5440393-contact-tags)

Si buscas información específica sobre las Campañas en CloudTalk, la encontrarás [aquí.](/es/articles/8428838-setting-up-campaigns-legacy-dialer)

<h2 id="h_1397798814">
  Configurar un flujo de trabajo para automatizar el etiquetado de contactos
</h2>

Las *Automatizaciones de flujo de trabajo* son escenarios automatizados y personalizables que encontrarás en el Dashboard, en la pestaña **Cuenta**.

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

Nuestra empresa suele organizar campañas de llamadas para leads de llamadas salientes, pero añadir etiquetas manualmente para distinguir estos nuevos contactos ralentiza el proceso.

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

Reconocer si se ha producido una llamada saliente contestada y, en tal caso, añadir una nueva etiqueta: `outbound_lead`.

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

1. Antes de crear el flujo de trabajo, tendremos que generar un conjunto único de claves de API para usarlas más adelante. Desde el Dashboard, ve a **Cuenta->Configuración** y haz clic en el encabezado *Claves de API*. Si es necesario, genera un par de claves de API sin usar con el botón **`+ Agregar clave de API`**. Copia y pega estos valores en un documento privado o guárdalos de otra forma para utilizarlos más adelante en el proceso.

2. En **Cuenta -> Automatizaciones de flujo de trabajo** del [Dashboard](https://dashboard.cloudtalk.io/login), haz clic en el botón azul **`+ Agregar Flujo de Trabajo`**.

   <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. Ponle al flujo de trabajo un **Nombre** descriptivo.

   <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. El primer paso de filtrado de cualquier flujo de trabajo es el [activador](/es/articles/5648924-triggers). Queremos que el objeto del activador sea una **llamada** y, como acción del activador, elegimos **finalizada**. Con esta combinación, nuestra automatización se activará cuando termine una llamada.

   <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. Nuestro objetivo en este ejemplo también requiere establecer algunas [condiciones](/es/articles/5649346-conditions) adicionales. La automatización no debería activarse después de cada llamada finalizada. En primer lugar, no queremos incluir las llamadas sin tiempo de conversación, ya que serían llamadas cortadas. Configura este filtro creando una condición con un valor dinámico. Haz clic en el campo **Propiedad**. Después, en la sección *Datos útiles para tus flujos de trabajo* de la derecha, haz clic en **`talking_time`** para que el campo se rellene con el valor dinámico correspondiente. La notación resultante debe coincidir con la de la imagen de abajo. Como **Operando**, elige **es mayor que** y, como **Valor**, introduce `10` para compensar el retardo de conexión que pueda producirse.

   <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 condición filtrará las llamadas con un tiempo de conversación
   superior a diez segundos. 
   ```

6. Conviene añadir otra condición para filtrar solo las llamadas salientes. **+ Agregar condición**. Rellena el campo **Propiedad** igual que en la condición anterior, esta vez con el valor dinámico de **direction**. Como **Operando**, elige **es igual a**, que buscará una coincidencia exacta de caracteres. Escribe `outgoing` todo en minúsculas como **Valor**. Si no hay que añadir más condiciones, podemos pulsar **`Confirmar y 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. Hay tres tipos de [acciones](/es/articles/5649782-actions) entre los que elegir. Para este ejemplo, enviaremos información de vuelta a través de la api de CloudTalk. Esto requiere una acción **Solicitud de API**.

8. La acción **Solicitud de API** está pensada para ser flexible, por lo que los usuarios tendrán que consultar documentación y recursos adicionales para dar el formato correcto a los encabezados y los valores. Como en este ejemplo queremos hacer una solicitud de API a la api de CloudTalk, podemos consultar la [Referencia de la API de CloudTalk](/developers#section/API-Overview) para dar con el formato adecuado. Primero hay que introducir un **Punto final.** Desglosándolo, el punto final necesario incluirá una referencia a la dirección web o token ([`https://my.cloudtalk.io/api`](https://my.cloudtalk.io/api)), una referencia al aspecto de la dirección que queremos manipular (`contacts`), una referencia al contacto concreto en cuestión (`the contact id`), una referencia a la función que queremos ejecutar para ese contacto (`addTags`) y, por último, un tipo de formato (`.json`). Siguiendo la documentación de la API enlazada más arriba**,** el formato de nuestro **Punto final** será así**:**

   **[`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**, elegimos **PUT**, pidiéndole al sistema que *introduzca* información nueva en la base de datos si aún no existe. Fíjate también en que, en la imagen, `contactId` aparece resaltado porque hay que sustituirlo por un valor dinámico que permita a la API hacer referencia al ID real de un contacto concreto.

9. La referencia de valor dinámico que hay que insertar en lugar de `{contactId}` es esta:

   `#{{ 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. La mayoría de las llamadas a la API requieren algún tipo de autorización. Aquí es donde entran en juego las claves de API que obtuvimos en la página de **Configuración**. Por la forma creativa en la que estamos haciendo una solicitud de vuelta a través de la propia API de CloudTalk, tendremos que abrir una pestaña aparte y recurrir a una plataforma de API como Workato, SAP Integration o AWS para construir el formato correctamente codificado de nuestro encabezado de autorización. A modo de ejemplo, abajo tienes una imagen de cómo podría verse la combinación del Access Key ID y el Access Key Secret en la interfaz de Postman. Las dos claves se introducen como valores de autorización básica y el resultado será un encabezado con formato, con una Clave y un Valor de cadena cifrada.

    <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: La navegación por la página web y los nombres de los campos variarán ligeramente según la plataforma de API que utilices. 
    ```

    <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. Una vez que tengamos un par Clave:Valor con el formato correcto, introduciremos estas secuencias en los campos del mismo nombre de la sección *Encabezados* de nuestra solicitud de API de 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. En la sección *Valores* de la solicitud podemos definir el nombre de la etiqueta que queremos añadir cuando se active la automatización. Como **Clave**, introduce `tags.0` para hacer referencia a la lista de etiquetas. Escribe el nombre de la etiqueta que quieras en el campo **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. Si no hay que añadir más encabezados ni valores, podemos revisar nuestra **acción Solicitud de API** y asegurarnos de que todos los campos tienen el formato correcto. Después, **`Confirmar y continuar`**.

14. Cuando hayamos guardado la automatización y la hayamos puesto en *Activo*, podrá empezar a ejecutarse. En los casos en que se cumplan las condiciones, nuestra etiqueta `outbound_lead` se añadirá automáticamente a los perfiles de contacto que todavía no la tengan.

***

<h2 id="h_ae059d4dd2">
  ¿Por qué no funciona mi automatización?
</h2>

Prueba un escenario que debería activar la automatización y consulta el contador de «ejecuciones este mes» para ver el resultado.

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

Según si el recuento ha subido o bajado tras actualizar la página, revisa estos escenarios habituales para ver si se aplican a tu situación. Si el problema continúa, ponte en contacto con el equipo de atención al cliente de CloudTalk.

* ### El recuento de «ejecuciones este mes» no sube

  Esto significa que la automatización no se está activando, lo que indica que no se cumplen las condiciones establecidas. Asegúrate de que las condiciones sean lógicas e incluyan los eventos que deberían activar la automatización.

* ### El recuento de «ejecuciones este mes» sube, pero mi acción de API no se ejecuta

  Lo más probable es que se deba a algún error en la estructura de la API en el paso de acción de la automatización. Comprueba que:

  * el punto final tiene el formato correcto, tal y como se muestra en los pasos anteriores

  * se usan valores dinámicos en lugar de marcadores de posición de formato como «`ContactId`»

  * se ha aplicado correctamente un encabezado de autorización

  * las cadenas de **Clave** de la sección *Valores* de la solicitud están escritas en el [formato que espera el intérprete de la API](/developers#tag/Tags/paths/~1tags~1index.json/get)

***

*¿Necesitas ayuda o tienes alguna pregunta?* Escríbenos a través de nuestro [Portal de atención al cliente](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) : estamos aquí para ayudarte.


## Related topics

- [Guía de Automatizaciones de flujo de trabajo](/es/articles/10568412-workflow-automations-guide.md)
- [Etiquetas de contacto](/es/articles/5440393-contact-tags.md)
- [Etiquetas](/es/articles/10657499-tags.md)


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