Tools de Front
Las 13 operaciones de Front que tu producto ejecuta en la cuenta de tu cliente con Connect. Todas usan el mismo endpoint, POST /api/tools/{tool}/execute.
- 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.
- Listar bandejasGETLista las bandejas de la empresa con id y name. El id es el inbox_id de Actualizar conversación y del filtro inbox: de Buscar conversaciones.
- Listar compañerosGETLista los compañeros de la empresa con id, email, username, name y availability. El id es el assignee_id y el author_id de las otras herramientas y del filtro assignee: de Buscar conversaciones.
- Listar etiquetasGETLista las etiquetas de la empresa, del equipo y personales a las que llega el token de API, con id, name y description. El id va en tag_ids y en el filtro tag: de Buscar conversaciones.
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.
