> ## Documentation Index
> Fetch the complete documentation index at: https://semantiks.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Cómo integrar con Freshchat

> Guía paso a paso para conectar tu agente Semantiks AI con Freshchat.

<Tip>
  Esta integración conecta Freshchat (la plataforma de mensajería de Freshworks) con un agente conversacional de Semantiks. Así, los mensajes que los usuarios envían por el chat de Freshchat serán gestionados automáticamente por nuestro agente de IA como primera línea de soporte. Si tienes habilitada la herramienta de escalamiento, los usuarios podrán ser transferidos a tu equipo humano en Freshchat cuando sea necesario.
</Tip>

## Resumen rápido de los pasos

Integrar Freshchat con Semantiks es un proceso sencillo y rápido. Solo necesitas seguir cuatro pasos básicos para conectar ambos sistemas y empezar a gestionar tus conversaciones automáticamente.

1. Obtén el **App ID** desde la configuración del widget web de Freshchat.
2. Accede a la sección de integraciones para conseguir tu **API Key** y el **Base URL** de tu cuenta.
3. El siguiente paso es configurar el **Webhook** y copiar la **Public Key** que Freshchat te proporcionará para asegurar la comunicación.
4. Por último, simplemente ingresa estos datos en la consola de Semantiks y activa el canal.

¡Así de fácil! En pocos minutos tendrás tu agente de IA listo para responder a tus usuarios en Freshchat.

***

<Steps>
  <Step title="Obtener el App ID">
    <Info>
      El App ID es un identificador único de tu configuración de Freshchat. Lo vamos a encontrar en los ajustes de integración del widget web.
    </Info>

    **Pasos**

    1. Entra a la consola de Freshchat.
    2. En el menú lateral izquierdo, haz clic en <strong>Admin Settings</strong>.
           <img src="https://mintcdn.com/semantiks/iiGB1dOT3hFeLrhi/images/integration-guides/how-to-integrate-freshchat/fresh1.png?fit=max&auto=format&n=iiGB1dOT3hFeLrhi&q=85&s=0c0c2786f73c4c92b116f7922dac4168" alt="Paso 1 - Freshchat" width="1359" height="959" data-path="images/integration-guides/how-to-integrate-freshchat/fresh1.png" />
    3. Busca y entra a la sección <strong>Configuration and Workflows</strong> (en la interfaz suele aparecer en inglés; equivale a configuración y workflows).
    4. Selecciona la opción <strong>Webchat Settings</strong>.
           <img src="https://mintcdn.com/semantiks/iiGB1dOT3hFeLrhi/images/integration-guides/how-to-integrate-freshchat/fresh2.png?fit=max&auto=format&n=iiGB1dOT3hFeLrhi&q=85&s=2ebfebaee97536a6b3ad85863197fb95" alt="Paso 2 - Freshchat" width="1361" height="962" data-path="images/integration-guides/how-to-integrate-freshchat/fresh2.png" />
    5. Luego, haz clic en <strong>Integration Settings</strong>.
    6. Aquí encontrarás tu <strong>App ID</strong> —cópialo y guárdalo.
           <img src="https://mintcdn.com/semantiks/iiGB1dOT3hFeLrhi/images/integration-guides/how-to-integrate-freshchat/fresh3.png?fit=max&auto=format&n=iiGB1dOT3hFeLrhi&q=85&s=62d03968ad90edaf97cda03ff15503ea" alt="Paso 3 - Freshchat" width="1362" height="964" data-path="images/integration-guides/how-to-integrate-freshchat/fresh3.png" />
  </Step>

  <Step title="Obtener API Key y Base URL">
    <Info>
      El API Key y el Base URL nos van a permitir autenticar integración del Agente hacia Freshchat desde Semantiks.

      * **API Key:** Es una clave secreta única que identifica y autoriza a tu cuenta para interactuar con la API de Freshchat. Permite que Semantiks pueda enviar y recibir información de tu cuenta de Freshchat de forma segura.
      * **Base URL:** Es la dirección base del servidor de Freshchat donde está alojada tu cuenta (por ejemplo, según la región: EU, US, IN, etc.). Todas las peticiones a la API se hacen a partir de esta URL, asegurando que los datos se envíen al entorno correcto.
    </Info>

    **Pasos**

    1. Regresa al panel principal de <strong>Admin Settings</strong>.
           <img src="https://mintcdn.com/semantiks/iiGB1dOT3hFeLrhi/images/integration-guides/how-to-integrate-freshchat/fresh1.png?fit=max&auto=format&n=iiGB1dOT3hFeLrhi&q=85&s=0c0c2786f73c4c92b116f7922dac4168" alt="Paso 1 - Freshchat" width="1359" height="959" data-path="images/integration-guides/how-to-integrate-freshchat/fresh1.png" />

    2. Ahora ve a <strong>Marketplace and Integrations</strong>.

    3. Dentro de esta sección, selecciona <strong>API Settings</strong>.
           <img src="https://mintcdn.com/semantiks/iiGB1dOT3hFeLrhi/images/integration-guides/how-to-integrate-freshchat/fresh4.png?fit=max&auto=format&n=iiGB1dOT3hFeLrhi&q=85&s=e1a30b2d30be40687435387b2bdd47b8" alt="Paso 4 - Freshchat" width="1361" height="962" data-path="images/integration-guides/how-to-integrate-freshchat/fresh4.png" />

    4. Aquí podrás ver y copiar:
       * **API Key**
       * **Base URL**
             <img src="https://mintcdn.com/semantiks/dTnNcSHJZt4I8UN-/images/integration-guides/how-to-integrate-freshchat/fresh5.png?fit=max&auto=format&n=dTnNcSHJZt4I8UN-&q=85&s=d93102eee66dd9a7f87eed051e473548" alt="Paso 5 - Freshchat" width="1360" height="963" data-path="images/integration-guides/how-to-integrate-freshchat/fresh5.png" />

    Es muy importante guardar estos valores en un lugar seguro. La API Key es sensible y no debe compartirse públicamente.
  </Step>

  <Step title="Configurar Webhook y Obtener Public Key">
    <Info>
      El Webhook y la Public Key son esenciales para asegurar la comunicación entre Freshchat y Semantiks.

      * **Webhook:** Es la URL a la que Freshchat enviará automáticamente los mensajes y eventos generados en tu chat. Así, Semantiks podrá recibir y procesar las conversaciones en tiempo real.
      * **Public Key:** Es una clave pública que Freshchat genera para tu integración. Permite a Semantiks verificar que los mensajes realmente provienen de Freshchat y no han sido alterados, garantizando la seguridad de la integración.
    </Info>

    **Pasos**

    1. Sigue en la misma sección de <strong>API Settings</strong> dentro de <strong>Marketplace and Integrations</strong>, debemos seleccionar <strong>Conversation Webhooks:</strong>
           <img src="https://mintcdn.com/semantiks/dTnNcSHJZt4I8UN-/images/integration-guides/how-to-integrate-freshchat/fresh6.png?fit=max&auto=format&n=dTnNcSHJZt4I8UN-&q=85&s=8edec3d0420f712887bf4053300df0c5" alt="Paso 6 - Freshchat" width="1361" height="962" data-path="images/integration-guides/how-to-integrate-freshchat/fresh6.png" />

    2. Haz clic en el botón <strong>Enable</strong>, si aún no lo has activado.
           <img src="https://mintcdn.com/semantiks/dTnNcSHJZt4I8UN-/images/integration-guides/how-to-integrate-freshchat/fresh7.png?fit=max&auto=format&n=dTnNcSHJZt4I8UN-&q=85&s=3f3f9b423cc33e45b43ac2db408cb484" alt="Paso 7 - Freshchat" width="1364" height="965" data-path="images/integration-guides/how-to-integrate-freshchat/fresh7.png" />

    3. Una vez habilitada la sección, en la primera caja de texto *Webhook*, pega esta URL:
       ```bash Webhook URL theme={null}
       https://semantiks-switchboard-922021458660.us-central1.run.app/webhooks/freshchat
       ```
           <img src="https://mintcdn.com/semantiks/dTnNcSHJZt4I8UN-/images/integration-guides/how-to-integrate-freshchat/fresh8.png?fit=max&auto=format&n=dTnNcSHJZt4I8UN-&q=85&s=f9e4646f35d1510ef485239f8fb6b0e0" alt="Paso 8 - Freshchat" width="1363" height="963" data-path="images/integration-guides/how-to-integrate-freshchat/fresh8.png" />

    4. Al activar el webhook, Freshchat te mostrará una <strong>Public Key</strong> en la seccion *Authentication* que debes copiar . Esta clave será necesaria para verificar que los mensajes vienen realmente de Freshchat.
           <img src="https://mintcdn.com/semantiks/dTnNcSHJZt4I8UN-/images/integration-guides/how-to-integrate-freshchat/fresh9.png?fit=max&auto=format&n=dTnNcSHJZt4I8UN-&q=85&s=a88bff15b9690eb1b39396172b4538ba" alt="Paso 9 - Freshchat" width="1362" height="965" data-path="images/integration-guides/how-to-integrate-freshchat/fresh9.png" />
  </Step>

  <Step title="Finalizar integración en Semantiks">
    <Note>
      Para completar la integración, necesitarás los siguientes datos que obtuviste en los pasos anteriores:

      * **App ID**
      * **Public Key**
      * **Base URL**
      * **API Key**
    </Note>

    1. Entra a la <strong>consola de Semantiks</strong> con tu cuenta.
    2. En el menú de la izquierda, haz clic en <strong>Canales</strong> y selecciona la pestaña de <strong>canales externos</strong>.\\
           <img src="https://mintcdn.com/semantiks/iiGB1dOT3hFeLrhi/images/integration-guides/how-to-integrate-freshchat/fresh11.png?fit=max&auto=format&n=iiGB1dOT3hFeLrhi&q=85&s=2f348c3f3027a361d351af6c1e9e0653" alt="Paso 11 - Freshchat" width="1363" height="962" data-path="images/integration-guides/how-to-integrate-freshchat/fresh11.png" />
    3. Busca el recuadro de <strong>Freshchat</strong> y haz clic en el botón <strong>Conecta</strong>.
           <img src="https://mintcdn.com/semantiks/iiGB1dOT3hFeLrhi/images/integration-guides/how-to-integrate-freshchat/fresh12.png?fit=max&auto=format&n=iiGB1dOT3hFeLrhi&q=85&s=434e62027e3ec22bbfa88a7db44d9a86" alt="Paso 12 - Freshchat" width="1363" height="962" data-path="images/integration-guides/how-to-integrate-freshchat/fresh12.png" />
    4. Al dar click, se abrirá un formulario donde deberás ingresar los siguientes campos:

       * **App ID**
       * **Public Key**
       * **Base URL**
       * **API Key**

           <img src="https://mintcdn.com/semantiks/iiGB1dOT3hFeLrhi/images/integration-guides/how-to-integrate-freshchat/fresh13.png?fit=max&auto=format&n=iiGB1dOT3hFeLrhi&q=85&s=722228f1ea61a97b4b73c016290e7b83" alt="Paso 13 - Freshchat" width="1363" height="1155" data-path="images/integration-guides/how-to-integrate-freshchat/fresh13.png" />
    5. Una vez llenados todos los campos, haz clic en <strong>Conecta</strong> y la integración estará activa.

    ¡Listo! Tu agente Semantiks ya está conectado a Freshchat y listo para empezar a conversar con tus usuarios.
  </Step>
</Steps>