¿Cómo podemos ayudar?

Talkdesk Automation Flows le permite iniciar un flujo en función de algo que sucede en Talkdesk (un activador de evento de Talkdesk) o en función de algo que sucede en un sistema externo. 

Para los sistemas externos, hay dos opciones:

• Activación por API: Su sistema llama a Talkdesk API, autenticada con un token OAuth.
• Activación por Webhook: Su sistema envía una solicitud HTTP POST a una URL única que Talkdesk genera para el flujo. No se necesita OAuth.

¿Cuál debería usar?

Utilice el activador de API cuando controle el código de llamada y desee la autenticación estándar de Talkdesk API, la expiración del token y el acceso delimitado. Utilice Webhook cuando el otro sistema decida lo que envía y no pueda realizar una autorización de OAuth.

Opción 1: Activador de API

1. Elija API como el desencadenante del flujo. En Automation Flows, cree un flujo y añada el activador de API como el primer paso.
2. Defina las variables. En el desencadenante, añada las variables que enviará el llamante, por ejemplo, customer_id y order_id. Se convertirán en los parámetros del cuerpo de la petición. Si el usuario que llama omite alguno, quedará sin definir.
3. Guarde y publique el flujo.
4. Cree un cliente OAuth con la plataforma de flujos: envíe el alcance, siguiendo la guía de credenciales del cliente. Guarde el ID y la contraseña del cliente en su gestor de secretos.
5. Copie el fragmento de código. Abra el activador en el editor de flujos y haga clic en Copy code. Esto generará una llamada lista para usar con su ID de flujo y variables completadas.
6. Compruebe el resultado. Una respuesta satisfactoria significa que se ha activado el flujo. Utilice el historial de ejecución del flujo para ver cómo se realizó la ejecución.

Notas:

• Las peticiones de API están limitadas a 10 por segundo.
• Los tokens caducan. Petición de uno nuevo cuando caduque el anterior en lugar de codificarlo directamente.

Opción 2: Activación de Webhook

1. Elija Webhook como el activador del flujo. Añada el activador de Webhook como el primer paso.
2. Defina las variables. Añada una variable para cada campo que el remitente incluya en su carga útil, con un nombre exactamente igual al del campo.  Una variable se mantiene vacía si el remitente no la envía.
3. Copie la URL del Webhook. El editor muestra una URL única en el formulario {talkdesk_api_url}/flows-platform/webhooks/{token}. Haga clic en Copy code para obtener una muestra de curl.
4. Guarde y publique el flujo. El flujo debe publicarse para que se inicie el Webhook.
5. Pegue la URL en el sistema externo como destino del Webhook POST. Seleccione application/json o application/x-www-form-urlencoded.
6. Pruebe:

curl --request POST \
  --url {webhook_url} \
  --header 'Content-Type: application/json' \
  --data '{
    "customer_id": "CUSTOMER-ID-PLACEHOLDER",
    "order_id": "ORDER-ID-PLACEHOLDER"
  }'

7. Compruebe el resultado. Una llamada exitosa devuelve HTTP 200 con un cuerpo vacío. Una URL no válida o desconocida devuelve un error, por lo que tiene que volver a copiar la URL desde el editor. Utilice el historial de ejecución del flujo para ver la carga útil recibida y cómo se realizó la ejecución.

Mantener la URL segura

• Tratar la URL como una contraseña. Cualquier persona que la tenga puede activar el flujo. No la pegue en tickets, chats o archivos públicos.
• Si cree que se ha filtrado, haga clic en Regenerate en el componente Webhook, luego actualice la URL en el sistema externo, guarde y publique. La URL anterior seguirá funcionando hasta que guarde y publique el flujo, por lo que puede realizar el cambio sin interrupciones.

Resolución de problemas

Para saber más sobre cómo solucionar problemas en su flujo, consulte este artículo.