CRM y ventas
folk en tu producto y en tus agentes de IA, con una API
El toolkit de folk cubre grupos y sus campos personalizados, personas, empresas, negocios (y otros objetos de un grupo) y notas: listar, crear y actualizar. El cliente conecta con una clave de API que Connect guarda, y cada ejecución queda registrada, para que tu producto o agente de IA trabaje el CRM sin una integración propia.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/folk_create_person/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"firstName": "<firstName>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a folk.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de folk. 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 folk.
Sincronizar leads al CRM
Cuando alguien se registra en tu SaaS, crea una persona, vincúlala a una empresa y agrégala a un grupo para que aparezca en el pipeline.
Mover negocios en el pipeline
Lista los negocios de un grupo y actualiza el campo personalizado Status cuando tu producto detecte un cambio, lo que mueve el negocio en el pipeline.
Notas escritas por un agente de IA
Un agente resume una llamada o un email y añade el texto como nota en Markdown a la persona, empresa o negocio correcto.
Tools
13 tools de folk
- Listar gruposGETLista los grupos del workspace con id y nombre. Los grupos contienen personas, empresas y negocios. La página siguiente viene del cursor dentro de pagination.nextLink; la última página no tiene nextLink.
- Listar campos personalizados del grupoGETLista los campos personalizados de un grupo para personas, empresas o un tipo de objeto, con nombre, tipo y las opciones de los campos de selección. En persona o empresa, cada campo de tipo objectField es un tipo de objeto del grupo, como Deals, y su nombre es el objectType de las tools de objeto.
- Listar personasGETLista las personas del workspace con id, nombres, emails, teléfonos, cargo, empresas, grupos y valores de los campos personalizados. La página siguiente viene del cursor dentro de pagination.nextLink; la última página no tiene nextLink.
- Crear personaPOSTCrea una persona, opcionalmente en grupos y vinculada a empresas. folk fusiona duplicados en segundo plano, lo que puede sobrescribir parte de los datos enviados. Una persona sin grupo solo aparece en la búsqueda de folk.
- Actualizar personaPATCHActualiza una persona, cambiando solo los campos enviados. Una lista (groups, companies, emails, phones, addresses, urls) sustituye a la actual, así que envíala completa. Dejar un grupo fuera quita a la persona de él, junto con los valores de sus campos personalizados en ese grupo.
- Listar empresasGETLista las empresas del workspace con id, nombre, sector, emails, teléfonos, URLs, grupos y valores de los campos personalizados. La página siguiente viene del cursor dentro de pagination.nextLink; la última página no tiene nextLink.
- Crear empresaPOSTCrea una empresa, opcionalmente en grupos. Los nombres son únicos en el workspace: un nombre existente devuelve esa empresa en lugar de crear otra. Una empresa sin grupo solo aparece en la búsqueda de folk.
- Actualizar empresaPATCHActualiza una empresa, cambiando solo los campos enviados. Una lista (groups, emails, phones, addresses, urls) sustituye a la actual, así que envíala completa. Dejar un grupo fuera quita a la empresa de él, junto con los valores de sus campos personalizados en ese grupo. Un nombre ya usado por otra empresa falla.
- Listar objetosGETLista los negocios, o los objetos de otro tipo, de un grupo, con id, nombre, personas y empresas vinculadas y valores de los campos personalizados, como el Status del negocio. La página siguiente viene del cursor dentro de pagination.nextLink; la última página no tiene nextLink. Un objectType desconocido responde 404 con los tipos de objeto del grupo.
- Crear objetoPOSTCrea un negocio, o un objeto de otro tipo, en un grupo. Las personas y empresas vinculadas ya deben estar en el grupo, o folk las ignora. Un nombre de campo personalizado desconocido hace fallar toda la solicitud con 422.
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 folk
¿Necesito implementar la API de folk?
No. Connect ya trae 13 tools de folk 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 folk?
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.
