CRM y ventas
Keap en tu producto y en tus agentes de IA, con una API
El toolkit de Keap cubre contactos, tags, oportunidades y etapas del embudo de ventas, notas, tareas y usuarios: listar, crear y actualizar contactos, aplicar o quitar tags, crear y mover oportunidades y registrar notas y tareas. El cliente conecta Keap una vez con OAuth, y tu producto o agente de IA llama a cada operación por un único endpoint de Connect.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/keap_create_contact/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"given_name": "<given_name>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Keap.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Keap. 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 Keap.
Captura de leads en Keap
Crea o actualiza un contacto cuando alguien se registra en tu producto, con duplicate_option para evitar duplicados, y aplica un tag que dispare la automatización correcta.
Embudo actualizado desde tu app
Crea una oportunidad en una etapa del embudo y cambia su stage_id cuando un negocio avance, para que el embudo del cliente refleje lo que pasa en tu producto.
Agente de IA como asistente de ventas
Deja que un agente encuentre un contacto, registre una nota tras una llamada y cree una tarea asignada al usuario correcto.
Tools
14 tools de Keap
- Listar contactosGETLista los contactos de la app Keap en contacts, con next_page_token para la página siguiente. Sin fields, cada contacto viene con un conjunto predeterminado de propiedades. Filtra por email, nombre, ids y otros campos con filter.
- Crear contactoPOSTCrea un contacto y lo devuelve. Requiere al menos un elemento en email_addresses, phone_numbers o addresses. Con duplicate_option, un contacto coincidente se actualiza en lugar de crear uno nuevo.
- Actualizar contactoPATCHActualiza los campos enviados y devuelve el contacto. Los campos omitidos mantienen sus valores, pero cada lista enviada (email_addresses, phone_numbers, addresses) reemplaza la lista completa.
- Listar tagsGETLista los tags de la app Keap en tags, con id, name, description y category, y next_page_token para la página siguiente.
- Crear tagPOSTCrea un tag y lo devuelve con su id. El tag no se aplica a nadie hasta Aplicar tag.
- Aplicar tagPOSTAplica un tag a uno o más contactos. Aplicar un tag puede disparar las automatizaciones de la app Keap que lo escuchan, como secuencias de email.
- Quitar tagPOSTQuita un tag de uno o más contactos. El tag en sí permanece en la app Keap.
- Listar oportunidadesGETLista las oportunidades del embudo de ventas en opportunities, cada una con su contacto, etapa y usuario, y next_page_token para la página siguiente.
- Crear oportunidadPOSTCrea una oportunidad para un contacto en una etapa del embudo y la devuelve. opportunity_title, contact_id y stage_id son obligatorios.
- Actualizar oportunidadPATCHActualiza los campos enviados y devuelve la oportunidad. Los campos omitidos mantienen sus valores. Mover la oportunidad a otra etapa es un cambio de stage_id.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/keap, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
Preguntas sobre el toolkit de Keap
¿Necesito implementar la API de Keap?
No. Connect ya trae 14 tools de Keap 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 Keap?
Con el modo que acepta el toolkit: OAuth con la app de tu producto. 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.
