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

1. Instalar paquete

pnpm add @mrtimmy/payload-connector

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

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ítulotitle
Texto del artículocontent
Resumenexcerpt
Título SEOmetaTitle
Descripción SEOmetaDescription
Slug de URLslug
Palabra clave principalfocusKeyword
Imagen destacadafeaturedImage
Imágenes dentro del textoMarkdown images in content
Categorías y etiquetascategories, tags

Payload espera

titleCampo de texto para el título del artículo
contentRich text o campo de texto para el contenido principal
slugCampo de URL para la ruta del blog
meta.titleTítulo SEO o campo SEO mapeado
meta.descriptionDescripción SEO o campo SEO mapeado
focusKeywordPalabra clave principal, si la web la guarda
featuredImageCampo de subida para la colección de medios
categoriesopcional: relación o campo para categorías
tagsopcional: relación o campo para etiquetas

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

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.