Marketing
WordPress.com en tu producto y en tus agentes de IA, con una API
El toolkit de WordPress.com cubre sitios, entradas y páginas, categorías, comentarios y sus respuestas, y estadísticas como visitas, entradas más vistas y referentes, en sitios de WordPress.com y sitios autoalojados conectados con Jetpack. Con Connect, tu producto o agente de IA lo llama todo por un solo endpoint, mientras Connect guarda y renueva las credenciales OAuth y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/wordpress_com_create_post/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"site": "<site>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a WordPress.com.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de WordPress.com. 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 WordPress.com.
Publica contenido desde tu app
Una herramienta de contenido crea una entrada como borrador o la publica de inmediato, y la actualiza cuando cambia el texto.
Modera la cola de comentarios
Un agente de IA lista los comentarios sin aprobar y los aprueba, los marca como spam o responde como el usuario conectado.
Informa del tráfico del sitio
Un panel de agencia lee visitas, visitantes, entradas más vistas y referentes de un sitio a lo largo de varios periodos.
Tools
12 tools de WordPress.com
- Listar sitiosGETLista los sitios de la cuenta, con el ID que piden las otras herramientas como site, el nombre y la URL. La conexión alcanza solo el sitio que el cliente eligió al autorizarla.
- Listar entradasGETLista las entradas o páginas de un sitio, de la más nueva a la más antigua, con found como total. Solo las publicadas por defecto; status lista las demás. Para leer la página siguiente, pasa el meta.next_page de la respuesta como page_handle.
- Obtener entradaGETDevuelve una entrada o página con título, contenido, extracto, estado, URL, categorías y etiquetas.
- Crear entradaPOSTCrea una entrada o página y la devuelve. El estado por defecto es publish, que la publica de inmediato: envía draft para guardarla sin publicar. Una vez publicada, también se comparte en las cuentas sociales conectadas al sitio, salvo que publicize sea false.
- Actualizar entradaPOSTActualiza una entrada o página y la devuelve. Solo cambian los campos enviados. Al editar un borrador, envía también status draft, para que el cambio nunca lo publique. status trash envía la entrada a la papelera.
- Listar categoríasGETLista las categorías de un sitio con ID, nombre, slug y post_count, ordenadas por nombre. Crear entrada y Actualizar entrada aceptan nombres o IDs de categoría.
- Listar comentariosGETLista los comentarios de un sitio, del más nuevo al más antiguo, con found como total y la entrada de cada comentario en post. Solo los aprobados por defecto; status unapproved lista la cola de moderación. La última página es cuando page por number alcanza found.
- Actualizar comentarioPOSTModera o edita un comentario y lo devuelve. status approved lo publica, unapproved lo devuelve a la cola de moderación, spam lo marca como spam y trash lo envía a la papelera.
- Crear respuesta a comentarioPOSTResponde a un comentario como el usuario conectado y devuelve la respuesta, que queda pública en el sitio.
- Obtener resumen de estadísticasGETDevuelve las visitas, visitantes, me gusta y comentarios de un sitio en los últimos num periodos hasta date, y el total de seguidores.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/wordpress_com, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
Preguntas sobre el toolkit de WordPress.com
¿Necesito implementar la API de WordPress.com?
No. Connect ya trae 12 tools de WordPress.com 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 WordPress.com?
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.
