Atención al cliente
Front en tu producto y en tus agentes de IA, con una API
El toolkit de Front cubre conversaciones y sus mensajes, etiquetas, comentarios internos, borradores, respuestas, mensajes nuevos y los canales, bandejas y compañeros a los que se refieren. Con Connect, tu producto o agente de IA lo llama todo por un solo endpoint, mientras Connect guarda el token de API y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/front_apply_tags/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"conversation_id": "<conversation_id>",
"tag_ids": []
}
}Cómo funciona
Del cliente conectado a la primera llamada a Front.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Front. 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 Front.
Borradores para revisar
Un agente de IA lee una conversación y crea un borrador de respuesta, para que un compañero lo revise y lo envíe en Front. Nada sale solo.
Triaje y enrutado de conversaciones
Una herramienta de soporte busca conversaciones, aplica etiquetas y actualiza el responsable o la bandeja.
Avisa a clientes desde tu app
Un producto envía un mensaje nuevo desde un canal o responde en una conversación existente cuando ocurre algo en la app.
Tools
13 tools de Front
- Buscar conversacionesGETBusca las conversaciones a las que llega el token de API, de la actividad más reciente a la más antigua, y devuelve _total con las coincidencias. Las conversaciones en la papelera quedan fuera, salvo que la consulta pida is:trashed. La página siguiente viene del page_token dentro de _pagination.next, que es null en la última página.
- Obtener conversaciónGETDevuelve una conversación con asunto, estado, responsable, destinatario principal, etiquetas, campos personalizados y enlaces. Los mensajes vienen de Listar mensajes de la conversación.
- Listar mensajes de la conversaciónGETLista los mensajes de una conversación, los más nuevos primero salvo que sort_order sea asc, con autor, destinatarios, asunto, cuerpo y detalles de los adjuntos. La página siguiente viene del page_token dentro de _pagination.next, que es null en la última página.
- Actualizar conversaciónPATCHActualiza el responsable, la bandeja, el estado, las etiquetas o los campos personalizados de una conversación. Envía solo los campos a cambiar. tag_ids reemplaza todas las etiquetas de la conversación; para añadir etiquetas sin quitar las demás, usa Aplicar etiquetas.
- Aplicar etiquetasPOSTAñade una o más etiquetas a una conversación y conserva las que ya tiene.
- Crear comentarioPOSTAñade un comentario interno a una conversación. Los comentarios solo los ven los compañeros, nunca el contacto. El cuerpo admite Markdown.
- Crear borradorPOSTCrea un borrador de respuesta al último mensaje de una conversación, para que un compañero lo revise y lo envíe en Front. No se envía nada. Un borrador privado solo lo ve su autor, así que define author_id con el compañero que lo revisará, o usa el modo shared.
- Responder a la conversaciónPOSTEnvía una respuesta en una conversación de inmediato y responde 202 con un message_uid. Front archiva la conversación cuando sale la respuesta, salvo que options.archive sea false. Requiere el permiso de envío en el token de API. Una conversación fusionada responde con una redirección a la conversación en la que se fusionó.
- Enviar mensajePOSTEnvía un mensaje nuevo desde un canal, lo que inicia una conversación nueva, y responde 202 con un message_uid. Sale de inmediato, y Front archiva la conversación nueva salvo que options.archive sea false. Requiere el permiso de envío en el token de API.
- Listar canalesGETLista los canales de la empresa, como direcciones de email, números de SMS y chat, con id, name, address, type y el enlace a su bandeja. El id es el channel_id de Enviar mensaje y Crear borrador.
Clave de API
Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.
Preguntas sobre el toolkit de Front
¿Necesito implementar la API de Front?
No. Connect ya trae 13 tools de Front 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 Front?
Con el modo que acepta el toolkit: Clave de API. 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.
