Atención al cliente
Freshdesk en tu producto y en tus agentes de IA, con una API
El toolkit de Freshdesk cubre tickets y sus conversaciones, campos de ticket, contactos y búsqueda de empresas. Tu producto o agente de IA los llama por Connect, que guarda las credenciales del cliente y registra cada ejecución, sin que construyas la integración.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/freshdesk_create_ticket/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"requester_id": 1
}
}Cómo funciona
Del cliente conectado a la primera llamada a Freshdesk.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Freshdesk. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Freshdesk.
Abre tickets desde tu producto
Un SaaS crea un ticket en Freshdesk cuando un usuario reporta un problema, identificando al solicitante por correo para que se cree un contacto nuevo si hace falta.
Copiloto de soporte para agentes
Un agente de IA busca tickets por estado o prioridad, lee la conversación y publica una nota privada o una respuesta al solicitante.
Contactos siempre sincronizados
Un CRM o herramienta de facturación crea y actualiza contactos en Freshdesk y los vincula a empresas encontradas por nombre.
Tools
13 tools de Freshdesk
- Listar ticketsGETLista tickets, los más recientes primero por defecto. Sin updated_since solo vuelven los tickets creados en los últimos 30 días, y spam o eliminados solo vienen con filtro.
- Buscar ticketsGETBusca tickets con una query de filtro, por ejemplo por estado, prioridad, agente, grupo, etiqueta o campo personalizado. Devuelve total y results, 30 tickets por página.
- Obtener ticketGETDevuelve un ticket con status, priority, requester_id, responder_id, group_id, tags, custom_fields y description.
- Crear ticketPOSTCrea un ticket. Identifica al solicitante con requester_id, email, phone o unique_external_id; un email o phone que aún no existe en Freshdesk crea el contacto.
- Actualizar ticketPUTActualiza un ticket: envía solo los campos a cambiar, y tags como la lista completa que el ticket debe conservar. Status 4 lo resuelve y 5 lo cierra.
- Listar conversaciones del ticketGETLista las respuestas y notas de un ticket, con body (HTML), body_text, private, incoming, user_id y source (0 respuesta, 2 nota). Las páginas se numeran desde 1.
- Crear respuesta en el ticketPOSTResponde al solicitante de un ticket. Freshdesk envía la respuesta por correo al solicitante, así que es visible para el cliente.
- Crear nota en el ticketPOSTAgrega una nota a un ticket. Las notas son privadas por defecto, visibles solo para los agentes; con private en false el solicitante también la ve.
- Listar campos de ticketGETLista los campos de ticket del helpdesk con sus opciones: ids de agentes en el campo de agente, ids de grupos en el campo de grupo, ids de productos y valores de estado.
- Listar contactosGETLista contactos, los clientes que abren tickets, con id, name, email, phone, mobile, company_id, tags y custom_fields. Los filtros se combinan.
Usuario y contraseña
Tu cliente ingresa las credenciales de la app en una pantalla de Connect, o tu sistema las envía con POST /api/customer-toolkits, sin pantalla.
Al conectar, tu cliente también indica {domain}: la dirección de su cuenta en la API de la app.
Preguntas sobre el toolkit de Freshdesk
¿Necesito implementar la API de Freshdesk?
No. Connect ya trae 13 tools de Freshdesk descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Freshdesk?
Con el modo que acepta el toolkit: Usuario y contraseña. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
