Saltar al contenido principal
Esta guía sirve para configurar una única empresa. Para suscripciones a los planes Business y Enterprise con múltiples usuarios, se ofrece una guía de integración personalizada.

Conecta tus cuentas de redes sociales

Inicia sesión o regístrate para obtener una cuenta de Ayrshare. En la página Social Account, haz clic en las redes sociales que quieras conectar. Asegúrate de otorgar todos los permisos.

Facebook Linking Example

Obtén tu API Key

Se requiere una API Key para autorizar el acceso a los endpoints de la API. Esta clave se usa en la cabecera de tus solicitudes y debe ir precedida por la palabra clave Bearer. Tu API Key se encuentra en el Dashboard de Ayrshare, en la página API Key. Si es necesario, cambia a tu ‘Primary Profile’ desde la página User Profiles. Desde ahí, puedes encontrar la página API Key en el panel lateral izquierdo. API Key Cada llamada a la API debe incluir la API Key en la cabecera usando un token Bearer. Incluye también el Content-Type con valor application/json.
Header
Consulta la sección Authorization para más información.

Envía tu primera publicación por API

Publicar el post

A continuación se muestran ejemplos de código en distintos lenguajes que ilustran cómo realizar una publicación con nuestra API. Para una integración aún más sencilla, puedes usar uno de nuestros paquetes SDK predefinidos. Para hacer una publicación necesitarás:
  • Tu API Key para la autenticación.
  • El contenido de texto de tu publicación.
  • Las plataformas de redes sociales en las que quieres publicar (incluye solo plataformas que hayas vinculado).
  • Opcional: URLs de las imágenes o videos que quieras incluir.
Todos los ejemplos usan el endpoint /post. Veamos un poco de código de ejemplo:
¿Publicando en X/Twitter? X requiere tus propias credenciales de API. Añade 2 cabeceras BYO (X-Twitter-OAuth1-Api-Key y X-Twitter-OAuth1-Api-Secret) a tu solicitud. Esto es una configuración única por cuenta de Ayrshare, y el mismo par de claves funciona para cada sub-perfil / usuario final. Consulta la guía de configuración para más detalles.
¡Felicidades! Acabas de enviar tu primera publicación.

Respuesta de la publicación

Recibirás una respuesta con un status de “success” cuando nuestra API procese correctamente tu publicación. La respuesta incluye:
  • status: Estado general de la llamada a la API (“success” o “error”)
  • errors: Arreglo con los errores encontrados (vacío si fue exitoso)
  • postIds: Arreglo de objetos con los detalles específicos de cada plataforma:
    • Nombre de la plataforma
    • ID de la publicación en esa plataforma
    • URL para ver la publicación
    • Información adicional específica de la plataforma
Cada plataforma en el arreglo postIds tendrá su propio status, lo que te permite verificar qué plataformas recibieron correctamente tu publicación. Revisa tus páginas de redes sociales para asegurarte de que la publicación se procesó correctamente y está en vivo. Ten en cuenta que algunas plataformas pueden tener una ligera demora antes de que las publicaciones aparezcan públicamente. Aquí tienes una respuesta de ejemplo:
Post Response
Consulta más ejemplos de código para llamar a la API de redes sociales en Node.js, Python, PHP, Golang, C# y Ruby, además de otras excelentes capacidades:

Post

Profundicemos un poco

Analicemos el proceso de lo que acaba de pasar cuando hicimos esta llamada a la API.
1

Configura la cabecera

Configuramos el token bearer de autorización en la cabecera (API Key) y el content type json.
2

Crea un objeto en el cuerpo

Luego, creamos un objeto en el body:
  • Post con el texto “Today is a great day!”.
  • Plataformas de redes sociales: Facebook, Instagram y LinkedIn. Debes incluir únicamente las plataformas que hayas vinculado en la página de Social Linkage.
  • Añadimos una imagen en mediaUrls.
3

Llama al endpoint /post

Enviamos todo como un HTTP POST al endpoint /post.

Antes de irte, algunas buenas prácticas

Lee la documentación

Mantenemos documentación extensa y actualizada. Ya que estás aquí, dedica un rato a revisar las secciones de la documentación en la navegación de la izquierda.

Los códigos de error son importantes

Debes manejarlos para que tus usuarios tengan una excelente experiencia.

Errores

Mantén tu API Key segura

Nos tomamos la seguridad muy en serio, y tú deberías hacer lo mismo. Tienes control total sobre la conexión entre Ayrshare y tus cuentas de redes sociales. Una vez conectadas las cuentas, la API Key de Ayrshare se convierte en el modo de autenticación. Por favor, mantén esta clave secreta y segura.

Publica posts de prueba

Puedes publicar posts de prueba con una cita, imagen o video aleatorios usando los parámetros randomPost, randomMediaUrl, e isLandscapeVideo o isPortraitVideo en el endpoint /post. Si usas randomPost, el parámetro post no es obligatorio.
Estas publicaciones son visibles en tus páginas de redes sociales, así que, si corresponde, elimínalas después de probar.

Cita aleatoria

Envía una cita aleatoria para probar la publicación agregando randomPost: true. Se usa con el endpoint /post.

Imagen aleatoria

Envía una imagen aleatoria agregando randomMediaUrl: true. Se usa con el endpoint /post.

Video aleatorio

Envía un video horizontal aleatorio agregando isVideo: true e isLandscapeVideo: true. El video tendrá el tamaño estándar horizontal. Se usa con el endpoint /post.
Envía un video vertical aleatorio, requerido para TikTok o para los Reels de Facebook/Instagram, agregando isVideo: true e isPortraitVideo: true. Se usa con el endpoint /post.

Comentario aleatorio

Envía un comentario aleatorio para probar la publicación de un comentario agregando randomComment: true. Se usa con el endpoint /comment.

Ejemplo de llamada cURL

Envía una cita aleatoria y un video vertical.

Usa Postman para probar tus llamadas a la API

Postman es una herramienta increíble para probar llamadas a APIs. Incluso puedes generar código en más de una docena de lenguajes.

Código de demostración

Si buscas un proyecto de demostración en React y NodeJS, consulta este repositorio de GitHub:

App de demostración de publicaciones sociales en GitHub

Solución de problemas comunes

A veces las cosas no salen bien, así que aquí tienes un poco de ayuda en nuestro centro de ayuda.

Solución de problemas

Contáctanos para obtener ayuda

Estamos aquí para ayudar, así que utiliza el chat en la esquina inferior derecha o envíanos un correo.