# Abrir tickets en Zendesk, Freshdesk o HubSpot para los traspasos

> Conecta Zendesk, Freshdesk o HubSpot para que cada traspaso de tu agente de intoCHAT abra también un ticket allí: configuración de cada helpdesk, qué contiene el ticket, privacidad y límites.

Cuando tu agente [traspasa una conversación por correo](/es/docs/handoff), también puede abrir un ticket en tu cuenta de Zendesk, Freshdesk o HubSpot. Así tu equipo responde desde el helpdesk que ya usa. La dirección de correo que el visitante dio para el traspaso es el solicitante del ticket, así que las respuestas desde el helpdesk le llegan por correo.

El correo de traspaso a tu equipo se sigue enviando como antes. El ticket es un extra.

> Los tickets solo se abren para los traspasos por correo. Primero activa **Offer hand-off by email** en la pestaña **Setup** y guarda. Consulta [Traspaso por correo](/es/docs/handoff#activarlo).

## Antes de empezar

Abre tu agente y ve a la pestaña **Setup**. La tarjeta **Helpdesk tickets** está justo debajo de **Hand-off to your team**. En **Helpdesk**, elige **Zendesk**, **Freshdesk** o **HubSpot** y sigue los pasos correspondientes de más abajo. Cada agente puede conectar un helpdesk.

Conectar y desconectar un helpdesk es cosa del propietario de la cuenta y de los admins, porque implica entregar credenciales. Los editors pueden activar y desactivar los tickets. Consulta [Miembros del equipo y roles](/es/docs/team).

## Conectar Zendesk

1. En el **Admin Center** de Zendesk, abre **Apps and integrations**, **APIs**, **Zendesk API**.
2. Activa **Token access** si está desactivado. Haz clic en **Add API token**, llámalo `intoCHAT` y copia el token. Zendesk solo lo muestra una vez.
3. En la tarjeta, introduce tu **Subdomain**: la parte anterior a `.zendesk.com`, por ejemplo `acme` para `acme.zendesk.com`.
4. En **Agent email**, introduce la dirección de correo del agente o admin en cuyo nombre se crean los tickets.
5. Pega el token en **API token** y haz clic en **Test and connect**.

intoCHAT inicia sesión con el correo del agente y el token, como describe Zendesk para los tokens de API. El token funciona para toda tu cuenta de Zendesk, así que elimínalo en Zendesk si dejas de usar intoCHAT.

## Conectar Freshdesk

1. En Freshdesk, haz clic en tu foto de perfil y abre **Profile settings**.
2. Haz clic en **View API key**, completa la comprobación que pide Freshdesk y copia la clave.
3. En la tarjeta, introduce tu **Freshdesk address**, por ejemplo `acme.freshdesk.com`. Usa la dirección `.freshdesk.com` aunque tu centro de ayuda tenga su propio dominio: la API de Freshdesk solo responde ahí.
4. Pega la clave en **API key** y haz clic en **Test and connect**.

La clave actúa en tu nombre en Freshdesk, así que usa el perfil de un agente que pueda crear tickets.

## Conectar HubSpot

1. En HubSpot, crea una app privada: **Development**, **Legacy apps**, **Create legacy app**, **Private**. En algunas cuentas está en **Settings**, **Integrations**, **Private apps**.
2. En **Scopes**, añade `crm.objects.tickets.read` y `crm.objects.tickets.write` (que en algunas cuentas aparecen como `tickets`), y además `crm.objects.contacts.read` y `crm.objects.contacts.write`.
3. Crea la app, abre su pestaña **Auth**, haz clic en **Show token** y copia el token de acceso.
4. Pégalo en **Access token** en la tarjeta y haz clic en **Test and connect**.

Los tickets nuevos van a tu pipeline de tickets predeterminado, en su primera fase que no esté cerrada. En una cuenta nueva de HubSpot es **Support Pipeline**, **New**. La tarjeta muestra qué pipeline y qué fase eligió intoCHAT. Todavía no puedes elegir otro pipeline en intoCHAT.

Cada ticket se archiva con el contacto del visitante: intoCHAT busca un contacto con la dirección de correo del visitante y crea uno si no existe. Si al token le faltan los ámbitos de contactos, el ticket se crea igualmente, sin contacto.

## Qué comprueba la conexión

**Test and connect** comprueba las credenciales con una lectura que no cambia nada en tu helpdesk:

| Helpdesk | Qué lee intoCHAT |
| --- | --- |
| Zendesk | El usuario al que pertenece el token. Tiene que ser un agente o un admin. |
| Freshdesk | Tu propio perfil de agente. |
| HubSpot | El ID de tu cuenta y tus pipelines de tickets. Un token que no puede leer tickets se rechaza. |

Si la comprobación falla, la tarjeta dice por qué, por ejemplo que no se aceptaron las credenciales o que ninguna cuenta responde en esa dirección. No se guarda nada hasta que la comprobación sale bien. Puedes comprobar credenciales hasta 10 veces en 10 minutos.

Las credenciales se guardan cifradas y no se vuelven a mostrar. La tarjeta solo muestra sus cuatro últimos caracteres y, en Zendesk, el correo del agente. Para cambiarlas, haz clic en **Replace credentials**.

## Qué contiene el ticket

- **Asunto**: `[Agent name] Chat hand-off:` y el primer mensaje del visitante, abreviado.
- **Solicitante**: la dirección de correo que dio el visitante para el traspaso, y su nombre cuando se conoce (de tu [formulario de leads](/es/docs/lead-collection) o de la [verificación de identidad](/es/docs/identity-verification)).
- **What they need**: el resumen breve del agente en el traspaso.
- **Summary**: de tres a cinco puntos redactados por IA sobre lo que quiere el visitante y lo que el agente ya respondió. Si el resumen no se puede escribir a tiempo, el ticket se crea sin él.
- **Visitor**: el correo, el nombre cuando se conoce, la página donde empezó el chat y el país del visitante, cuando se conoce.
- **Conversation**: los 30 últimos mensajes como texto plano, cada uno recortado a 1.000 caracteres. En conversaciones más largas se indica cuántos mensajes anteriores no aparecen. Las tarjetas de producto, los botones y otros elementos del widget no se incluyen.
- **In intoCHAT**: un enlace a la conversación en tu pestaña **Conversations**.

Cómo lo muestra cada helpdesk:

- **Zendesk**: el contenido es el primer comentario del ticket, añadido como **internal note**, y el ticket lleva la etiqueta `intochat`. Los disparadores propios de Zendesk se siguen ejecutando, por ejemplo el correo que avisa al solicitante de que se ha recibido su petición.
- **Freshdesk**: el contenido es la descripción del ticket. El ticket queda **Open**, con prioridad **Low**, y con la etiqueta `intochat`. Las notificaciones propias de Freshdesk al solicitante se siguen aplicando.
- **HubSpot**: el contenido es la descripción del ticket, en el pipeline y la fase que muestra la tarjeta.

## Cuándo se crea un ticket

El ticket se abre unos segundos después de la respuesta del agente al visitante, así que el visitante nunca espera a tu helpdesk. Solo se crea si el correo de traspaso a tu equipo salió de verdad.

- **Playground**: un traspaso desde el **Playground** abre un ticket real, marcado con `[Test]` al principio del asunto y con una línea arriba que indica que es una prueba, igual que el correo.
- **Chats temporales**: nunca, porque no se pueden traspasar.
- **Desactivado**: mientras el interruptor de la tarjeta está desactivado, los traspasos solo envían el correo.

## Dónde aparecen los tickets

- En la pestaña **Conversations**, la transcripción de una conversación traspasada muestra **Ticket #** y el número del ticket junto a la etiqueta **Handed off**. Al hacer clic se abre el ticket en tu helpdesk, en una pestaña nueva.
- Si el helpdesk rechazó el ticket, la transcripción muestra **Ticket couldn't be created** en su lugar. El correo de traspaso salió de todos modos. Revisa la tarjeta en la pestaña **Setup**: indica si las credenciales guardadas ya no funcionan.
- El [webhook](/es/docs/webhooks#datos-de-handoff-requested) `handoff.requested` incluye el helpdesk, el número y el enlace del ticket cuando se creó uno.

## Privacidad

Cuando conectas un helpdesk, cada traspaso envía la transcripción de la conversación, el resumen de IA, la dirección de correo del visitante y su nombre cuando se conoce, la página y el país al helpdesk que elegiste, dentro de tu cuenta en él. Ese helpdesk trata entonces los datos según sus propias condiciones. intoCHAT no lee nada de vuelta.

Informa de ello a los visitantes en tu propia política de privacidad si tu helpdesk no aparece ya en ella.

## Límites

- Un ticket por conversación. Un traspaso posterior en la misma conversación envía otro correo, pero no un segundo ticket.
- Sin sincronización en los dos sentidos: las respuestas, los cambios de estado y las notas del helpdesk no vuelven a intoCHAT. Responde al visitante desde el helpdesk.
- Un helpdesk por agente.
- Si el helpdesk no responde en 10 segundos, o está limitando las peticiones, ese ticket no se crea y no se reintenta.

## Desactivar o desconectar

- Desactiva **Open a ticket for each hand-off** para pausar los tickets. Las credenciales siguen guardadas.
- Haz clic en **Disconnect** para eliminar las credenciales guardadas. Los tickets ya abiertos se quedan en tu helpdesk y siguen enlazados en **Conversations**. Los correos de traspaso continúan como antes.

## Siguientes pasos

- Elige quién recibe el correo de traspaso: [Traspaso por correo](/es/docs/handoff).
- Envía también los traspasos a tus propios sistemas: [Webhooks](/es/docs/webhooks).
- Deja que tu equipo se una a la ventana del chat en su lugar: [Chat en vivo](/es/docs/live-chat).
