wp_create_comment: create a comment
Añade un comentario a una entrada, a través del flujo de moderación normal de WordPress.
Argumentos
| Argumento | Obligatorio | Significado |
|---|---|---|
post_id |
Sí | La entrada en la que comentar |
content |
Sí | El texto del comentario |
author |
No | El nombre del autor |
author_email |
No | El correo electrónico del autor |
dry_run |
No | Informar sin crear |
Permisos
Allow content writes abierto, y edit_post sobre la entrada de destino.
Ten en cuenta que se trata de la capacidad de entrada, no de moderate_comments. Crear un comentario se trata como una acción sobre la entrada.
Se atribuye al usuario que actúa
El comentario se crea con el ID del usuario autenticado adjunto. Es el comentario de tu cuenta, no uno anónimo, incluso si pasas un nombre author diferente.
Esa es la propiedad importante, y es lo que hace legítimos los usos legítimos: esta herramienta sirve para que tu sitio responda, no para fabricar una audiencia.
No generes prueba social
La prohibición que conviene enunciar con claridad: no uses esto para crear comentarios que parezcan venir de clientes.
Los testimonios generados, las preguntas inventadas para que una entrada parezca comentada o los comentarios positivos fabricados son tergiversaciones. En muchas jurisdicciones también son ilegales, y dañan la confianza de forma trivial cuando se descubren.
Los argumentos author y author_email existen para restaurar o migrar comentarios genuinos, no para inventar personas.
Esta es una de las pocas prohibiciones absolutas de esta documentación. Consulta Review AI output responsibly.
Usos legítimos
- Responder como sitio a la pregunta de un cliente, cuando la respuesta es genuinamente tuya.
- Restaurar un comentario que se eliminó por error, usando los datos del autor original.
- Migrar comentarios desde otro sistema, cuando los datos del autor son reales.
Pasa por la moderación
El comentario se crea a través del flujo normal de comentarios de WordPress, por lo que se aplican tus ajustes de moderación y cualquier plugin antispam. Según esos ajustes, el comentario puede publicarse de inmediato o quedar en la cola.
No des por hecho que está publicado. Lee el resultado de vuelta:
Crea la respuesta y luego muéstrame el estado del comentario.
Los comentarios deben estar abiertos
Si los comentarios están cerrados en la entrada, o deshabilitados en todo el sitio, la creación falla. Las herramientas no cambian los ajustes de comentarios: se trata de una opción de WordPress, y los ajustes de comentarios no están entre las cinco opciones modificables. Consulta Update an allowed public setting.
La simulación
Informa solo del ID de la entrada, sin crear nada. No reproduce el contenido, por lo que confirma el destino en lugar del texto.
Lee el contenido de vuelta para ti antes de crearlo: un asistente que redacta una respuesta en tu nombre está escribiendo con la voz de tu sitio, públicamente.
Revisa el texto antes de que sea público
Si el asistente redactó la respuesta, todo lo indicado en Review generated copy before publishing se aplica: hechos, compromisos, precios y cualquier cosa que suene a promesa.
Un comentario desde la cuenta del sitio es una declaración pública de tu negocio.
Qué devuelve
El ID del nuevo comentario, o un error.
Problemas comunes
| Síntoma | Causa |
|---|---|
| La escritura se rechaza | Compuerta de escritura de contenido cerrada |
pom_ai_mcp_post_not_found |
ID de entrada incorrecto, o un tipo de entrada no público |
pom_ai_mcp_forbidden |
Sin edit_post sobre la entrada de destino |
| El comentario no es visible | Pasó a la cola de moderación |
| La creación falló | Los comentarios están cerrados en esa entrada |
| Muestra el autor equivocado | El usuario que actúa se adjunta independientemente del argumento author |