PAYLOAD CMS

Conecta Payload con mr.timmy.

Instala el pequeño plugin de Payload, crea una clave de conector y añade la URL y la clave en timmy.

Para desarrolladores

Payload es code-first. Instala el conector como paquete npm, actívalo en la configuración de Payload, despliega y crea una clave en el panel de Payload.

Se mapean el título, el texto, los campos SEO, la imagen destacada, las imágenes dentro del texto, las categorías y las etiquetas. Si tu colección usa otros nombres, solo cambias el mapeo del snippet.

Para agentes: revisa primero la colección de Payload y ajusta después los nombres de campo en el snippet. La conexión de timmy solo necesita una URL de API y una clave de API.

Volver a integraciones

PAYLOAD CMS

1. Instalar paquete

pnpm add @mrtimmy/payload-connector

PAYLOAD CMS

2. Activar plugin

import { buildConfig } from "payload"
import { mrTimmyPayloadConnector } from "@mrtimmy/payload-connector"

export default buildConfig({
  plugins: [
    mrTimmyPayloadConnector({
      postsCollection: "posts",
      media: {
        collection: "media",
      },
      fields: {
        title: "title",
        content: "content",
        excerpt: "excerpt",
        slug: "slug",
        metaTitle: "meta.title",
        metaDescription: "meta.description",
        focusKeyword: "focusKeyword",
        featuredImageUrl: "featuredImage",
        categories: "categories",
        tags: "tags",
      },
      taxonomies: {
        categories: {
          collection: "categories",
          matchFields: ["slug", "title"],
        },
        tags: {
          collection: "tags",
          matchFields: ["slug", "title"],
        },
      },
    }),
  ],
})

Si usas Payload en Next.js, añádelo también a next.config.js como paquete externo del servidor.

const nextConfig = {
  serverExternalPackages: ["@mrtimmy/payload-connector"],
}

export default nextConfig

PAYLOAD CMS

3. Revisar mapeo

timmy envía estos valores. Si tus campos de Payload tienen otros nombres, solo cambian las rutas dentro de fields .

timmy envía

Título
title
Texto del artículo
content
Resumen
excerpt
Título SEO
metaTitle
Descripción SEO
metaDescription
Slug de URL
slug
Palabra clave principal
focusKeyword
Imagen destacada
featuredImage
Imágenes dentro del texto
Markdown images in content
Categorías y etiquetas
categories, tags

Payload espera

title
Campo de texto para el título del artículo
content
Rich text o campo de texto para el contenido principal
slug
Campo de URL para la ruta del blog
meta.title
Título SEO o campo SEO mapeado
meta.description
Descripción SEO o campo SEO mapeado
focusKeyword
Palabra clave principal, si la web la guarda
featuredImage
Campo de subida para la colección de medios
categories
opcional: relación o campo para categorías
tags
opcional: relación o campo para etiquetas

PAYLOAD CMS

4. Añadirlo en timmy

En el panel de Payload, bajo mr.timmy → Connector Keys crea una clave.

URL de API:
https://example.com/api/mrtimmy/create-post
Clave de API:
timmy_xxx

PAYLOAD CMS

Errores habituales

  • 401: La clave de API es incorrecta o está desactivada.
  • 404: El plugin no está instalado, no está desplegado o la ruta es incorrecta.
  • 500: Error del servidor de Payload. La respuesta indica el paso que falló: conversión de rich text, mapeo de taxonomías, subida de medios o creación en Payload.