Documentación
Documentación
La guía del panel, la referencia de la API pública, el SDK PHP y el paquete Laravel.
Guía Versión 1.0
-
Primeros pasos
Quiet Social publica para tus marcas en Facebook, Instagram, LinkedIn, Threads, Pinterest, Mastodon y Bluesky, al instante o en la fecha…
-
Espacios de trabajo y marcas
El espacio de trabajo es tu cuenta de equipo. Contiene tus marcas, tus conexiones a las redes, tus miembros y tu historial. Su dirección…
-
Conectar tus redes
Autoriza a Quiet Social en Meta, LinkedIn, Threads, Pinterest, Mastodon o Bluesky y luego vincula las cuentas encontradas a una marca: cada…
-
Destinos
Un destino es una cuenta concreta en la que publica una marca: una Página de Facebook, una cuenta profesional de Instagram, una Página de…
-
Publicaciones
Una publicación lleva un texto común, un enlace e imágenes opcionales, y sale hacia uno o varios destinos de una marca. Cada destino…
-
Medios
Cada marca tiene su biblioteca de imágenes. Una imagen se deposita en ella una vez y luego se adjunta a tantas publicaciones como quieras.
-
Calendario
El Calendario muestra tus publicaciones mes a mes o semana a semana, de lunes a domingo, cada una el día en que sale o salió; también…
-
Validación
Una publicación creada con Enviar a validación no sale mientras alguien no la haya validado. Dos vías: un miembro del equipo en el panel, o…
-
Equipo e invitaciones
Un espacio de trabajo se comparte. Cada miembro tiene en él un rol, que decide lo que puede hacer.
-
Historial
El Historial guarda constancia de lo que se ha hecho en el espacio de trabajo, y de quién lo ha hecho. Todos los miembros pueden leerlo.
-
Cuotas y consumo
Quiet Social mide, cada mes y para cada marca, las publicaciones creadas y las entregas con éxito en las redes. Una entrega es una…
-
Revocar una conexión
Revocar una conexión corta el acceso de Quiet Social a la cuenta de la red. Está reservado a los administradores y al propietario.
-
Eliminar tu cuenta
Eliminar tu cuenta corta tus accesos de inmediato y borra, siete días después, la cuenta y los espacios de trabajo de los que eres…
-
Claves API y webhooks
Una clave API permite a una aplicación — tu sitio web, tu tienda — publicar mediante la API en nombre del espacio de trabajo; un webhook…
-
Aplicaciones propias
Si una red bloquea la aplicación de Quiet Social, tus conexiones pueden pasar por una aplicación que tú mismo creaste en ella. Es una…
-
Plantillas
Una plantilla guarda un texto, un enlace, hashtags y, para una marca, destinos e imágenes, para partir de ellos en la próxima…
API Versión 1.0
-
Introducción
La API REST de Quiet Social permite que tu aplicación publique en las redes de una marca sin pasar por el panel: un artículo puesto en…
-
Autenticación
La API autentica una aplicación, no a una persona. Cada aplicación cliente recibe un identificador público y un secreto, que presenta…
-
Permisos
Un cliente de API solo puede llamar a las rutas cuyo permiso posee. Cada ruta declara el que exige; un cliente que no lo tiene recibe 403.
-
Idempotencia
El riesgo central de una API de publicación es publicar dos veces. Un cliente HTTP que pierde la respuesta a un POST lo reintentará y…
-
Marcas y destinos
Una marca es aquello para lo que publicas: una empresa, un cliente, un producto. Un destino es una cuenta concreta en la que publica una…
-
Publicaciones
Una publicación lleva un contenido común y un objetivo por cada destino elegido. Cada objetivo tiene su propio estado, su propio texto y su…
-
Medios
Una imagen se deposita en la biblioteca de una marca y luego se adjunta a una publicación mediante su identificador med_…. El depósito se…
-
Webhooks
Un webhook avisa a tu aplicación cuando una publicación cambia de estado, sin que tenga que consultar la API. Quiet Social envía una…
-
Errores
Esta página responde, para cada rechazo de la API, a una sola pregunta: ¿hay que reintentar?
-
Límites y convenciones
Lo que la API limita, y las convenciones que sigue en todas sus rutas: frecuencia, paginación, identificadores, fechas y cuotas.
-
Servidor MCP
Quiet Social expone un servidor MCP (Model Context Protocol): un asistente conversacional compatible puede leer tus marcas, tus destinos…
SDK PHP Versión 0.1
-
Introducción
El SDK PHP quiet-social/php-social publica en Facebook, Instagram, LinkedIn, Threads y Pinterest desde cualquier aplicación PHP. Habla…
-
Instalación y autenticación
El SDK se instala con Composer, sin ninguna dependencia, y se autentica con una clave API creada en el panel de Quiet Social: un…
-
Publicar
Un Post describe lo que hay que publicar, una sola vez para todas las redes, y publications()->create() lo publica en los destinos…
-
Imágenes
Una imagen acompaña a un post, o a una sola red mediante for(), junto con su texto alternativo. El SDK la envía a la API antes de crear…
-
Destinos
El parámetro to: de publications()->create() dice dónde publicar: nombres de red, identificadores de destino, o ambos. El SDK los…
-
Errores
Cada rechazo de la API se convierte en una excepción con nombre, que responde a la única pregunta que uno se hace tras un fallo: ¿puede…
-
Webhooks
La API avisa a tu aplicación cuando una publicación cambia de estado, con una petición POST firmada. El SDK declara los endpoints y…
-
Pruebas y transportes
El SDK envía cada petición mediante un transporte: CurlTransport por defecto, FakeTransport en tus pruebas, o una clase propia. Esta página…
Paquete Laravel Versión 0.1
-
Introducción
El paquete quiet-social/laravel-social publica tus modelos Eloquent en Facebook, Instagram, LinkedIn, Threads y Pinterest. El post se…
-
Instalación y configuración
El paquete se instala con Composer junto con el SDK PHP, crea su tabla mediante una migración, y se configura con variables de entorno…
-
Adoptar el paquete en una base existente
Lee esto antes de añadir PublishesToSocial a un modelo que ya tiene filas: sin el comando social:baseline, el primer guardado de cada…
-
Describir un post
Un modelo describe su post con el trait PublishesToSocial y atributos PHP, con métodos públicos de nombre convencional, o con ambos. Esta…
-
Métodos por convención y prioridades
Un método público del modelo, con nombre convencional y sin parámetros obligatorios, hace el mismo trabajo que un parámetro de atributo…
-
Sincronización automática
Cada guardado o eliminación de un modelo pone en cola un job que alinea el post remoto con el modelo: lo envía, lo sustituye mientras no…
-
Portadas
La portada de un post es su imagen: una Image del SDK, una URL, una ruta absoluta bajo una carpeta autorizada, o una ruta en un disco. El…
-
Publicar, cancelar y previsualizar a mano
El trait PublishesToSocial da tres métodos al modelo: publishToSocial() fuerza la sincronización, cancelSocialPublication() cancela el post…
-
Eventos de Laravel
El paquete emite ocho eventos de Laravel, todos en QuietSocial\Social\Events: tres vienen de la sincronización de tus modelos, cinco de los…
-
Webhooks
Con un secreto de firma, el paquete registra una ruta que recibe las notificaciones de Quiet Social, verifica cada una, mantiene al día…
-
Pruebas
SocialPublisher::fake() sustituye cualquier llamada a la API por un doble que registra cada post: tus pruebas comprueban lo que se habría…
-
El constructor manual
Para una publicación escrita a mano en lugar de descrita por un modelo, SocialPublisher::post() abre un constructor que se lee como una…
¿Una pregunta que esta documentación no resuelve?
Escríbenos: una respuesta que falta aquí es una página por completar.