Ir al contenido
Quiet Social

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

Usar Quiet Social a diario: conectar tus redes, preparar, someter a validación y programar tus publicaciones, seguir lo que se ha publicado.

  • 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

Publicar desde tu aplicación: autenticación, permisos, idempotencia, publicaciones, medios, webhooks y errores de la API REST v1.

  • 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

Publicar desde cualquier aplicación PHP con quiet-social/php-social: posts, imágenes, destinos, idempotencia, errores, webhooks y pruebas.

  • 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

Publicar sus modelos Eloquent con quiet-social/laravel-social: atributos y convenciones, sincronización automática, adopción sobre una base existente, eventos, webhooks y pruebas.

  • 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.