Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

API de redes sociales para agencias: gestiona las cuentas de tus clientes desde tu propio software

Una API de redes sociales para agencias permite que el propio software de la agencia conecte, publique, responda y genere informes sobre las cuentas de cada cliente. Con la Partner API de easyCoexistence, el número de WhatsApp de un cliente y sus cuentas de Instagram, Facebook, TikTok, YouTube y LinkedIn se unen a la cuenta de la agencia mediante enlaces alojados etiquetados con el id del cliente, y una sola clave API programa, enruta y supervisa todas ellas.

200 characters

La longitud máxima de external_ref que admite una sesión de conexión, el id propio de la agencia para el cliente, que se guarda en cada conexión.

1 hour

Cuánto tiempo funciona un enlace de conexión alojado para el cliente que lo abre.

Advanced Access

Lo que necesita una app de Meta para atender cuentas profesionales de Instagram que no posee ni gestiona, tras la App Review y la Business Verification.

ADMINISTRATOR

El rol de página de LinkedIn que necesita un miembro para el permiso rw_organization_admin, que gestiona las Páginas y lee sus informes.

End of cycle

Cuándo deja de cobrarse una conexión de cliente que la agencia elimina mediante la API.

¿Cómo organiza la API los clientes de una agencia?

Por tu id de cliente. Envíalo como external_ref en cada sesión de conexión; se queda en cada número y cuenta que crea la sesión y vuelve en cada evento de estado. GET /channels?external_ref=client_118 lista las cuentas sociales de ese cliente, con &channel=instagram para filtrar una sola red, y GET /connections?external_ref=client_118 lista sus números de WhatsApp. Todos los clientes están en la cuenta única de la agencia, bajo una sola clave ec_live_, y eso es lo que pone todo el recuento en un mismo tramo de precio.

One client's accounts
curl "https://easycoexistence.com/api/v1/channels?external_ref=client_118" \
  -H "Authorization: Bearer $EC_API_KEY"

curl "https://easycoexistence.com/api/v1/connections?external_ref=client_118" \
  -H "Authorization: Bearer $EC_API_KEY"

¿Cómo entrega el cliente el acceso?

A través de un enlace que envía la agencia. POST /connect-sessions con la red como channel, el external_ref del cliente y el nombre de la agencia como partner_name devuelve una url; el cliente la abre, inicia sesión en la pantalla de consentimiento de la propia red, o usa la ventana emergente de Meta y escanea un código QR para un número de WhatsApp, y vuelve a la redirect_url de la agencia. Un inicio de sesión de Facebook o LinkedIn puede traer varias Páginas a la vez, cada una como conexión propia, así que compara la lista con el brief del cliente.

¿Cómo publica la agencia para sus clientes?

Desde su propio flujo de aprobación. El software de la agencia guarda los borradores hasta que el cliente da su visto bueno y luego envía cada publicación aprobada a POST /channels/:id/posts con su publish_at, hasta 90 días antes. GET /channels/:id/posts da el calendario de una cuenta, GET /posts con un filtro de status muestra lo que espera entre clientes, y post.published y post.failed informan al gestor de cuentas de lo ocurrido. Las publicaciones de LinkedIn siempre pasan por la aprobación de una persona, que el paso de aprobación de la agencia ya proporciona.

¿Cómo responde la agencia a comentarios y DM de sus clientes?

Desde una sola bandeja que enruta por cuenta. PUT /channels/:id/webhook fija un destino para cada cuenta de Instagram, Página de Facebook y cuenta de TikTok, y cada comentario, mención o DM reenviado lleva el account_id, que asocia el mensaje con el cliente. Los mensajes de un número de WhatsApp van desde Meta a la webhook_url configurada para él. Las respuestas salen por la API de cada red con las credenciales de GET /channels/:id?credentials=1, y el equipo de la agencia también puede trabajar con varios clientes en Claude o ChatGPT mediante el conector MCP de la misma cuenta.

¿Cómo crea la agencia informes de sus clientes?

A partir de las analíticas de cada red, consultadas con las credenciales de la cuenta del cliente. Las métricas de Instagram y Facebook vienen de la Graph API de Meta, las de TikTok de su API for Business, las de YouTube de YouTube Analytics, cuya base incluyen las credenciales, y las de LinkedIn de sus endpoints de estadísticas. La tarea de informes de la agencia obtiene credenciales nuevas por cuenta al inicio de cada ejecución, descarga las cifras del período y las archiva bajo el external_ref del cliente.

¿Cómo sabe la agencia que la cuenta de un cliente necesita atención?

Por eventos de estado firmados. channel.disconnected y connection.disconnected llevan el external_ref del cliente, así que el software de la agencia puede avisar al gestor de cuentas de ese cliente y enviarle un enlace de conexión nuevo. Cada conexión se supervisa 24/7, y al propietario de la agencia también le llega un correo cuando una se cae. Un cliente que retira el acceso en los ajustes de la red aparece de la misma manera.

¿Qué ocurre en la API cuando un cliente se va?

La tarea de baja de la agencia lista las conexiones del cliente por external_ref y llama a DELETE /channels/:id y DELETE /connections/:id en cada una. El cobro de ellas se detiene al final del ciclo, las publicaciones programadas en un canal eliminado se cancelan y el token de una cuenta social eliminada se descarta. Un número de WhatsApp sigue en la Cloud API hasta que el cliente lo desconecta desde la app de WhatsApp Business.

Errores comunes

  • Poner en cola publicaciones de clientes antes de que el cliente las apruebe. Una publicación en cola se publica a su hora sin otra comprobación, así que retén los borradores en tu paso de aprobación y envíalos solo cuando estén aprobados.
  • Poner la clave de la Partner API en el front end del portal de un cliente. La clave llega a las credenciales de todos los clientes de la cuenta, así que manténla en el servidor de la agencia.
  • Esperar eventos de comentarios desde el canal de YouTube de un cliente o desde la Página de LinkedIn. easyCoexistence no recibe ninguno de los dos, así que el informe o el proceso de bandeja los lee a través de la API de cada red.
Hacerlo con EasyCoexistence

easyCoexistence da al software de la agencia una sola API para los números de WhatsApp de sus clientes y sus cuentas de Instagram, Facebook, TikTok, YouTube y LinkedIn, y más canales: enlaces de conexión alojados etiquetados por cliente, una cola de publicación, comentarios y DM reenviados, credenciales nuevas para los informes y cada conexión supervisada 24/7. De US$ 9 a US$ 0.75 por conexión al mes, con un precio que baja a medida que añades conexiones, y los primeros 3 días gratis.

Preguntas frecuentes

¿Necesitan los clientes su propia cuenta de easyCoexistence?

No. El cliente abre el enlace alojado e inicia sesión, y la conexión se une a la cuenta de la agencia, donde se cobra y se supervisa.

¿Puede la agencia mantener a los clientes con claves API separadas?

Una cuenta tiene una sola clave. Las claves separadas significan cuentas de easyCoexistence separadas, cada una facturada desde el primer tramo, así que la mayoría de agencias separan a los clientes por external_ref.

¿Puede el cliente ver el nombre de la agencia al conectarse?

Sí. La página alojada muestra el nombre enviado como partner_name. La pantalla de consentimiento de la red nombra a easyCoexistence como la app que pide acceso.

¿Cuánto cuesta easyCoexistence para una agencia?

De US$ 9 a US$ 0.75 por conexión de cliente al mes, con un precio que baja a medida que la agencia añade clientes, igual en todas las redes, y los primeros 3 días gratis.

Sigue leyendo

Conecta tu primer canal en dos minutos.

Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.

  • 3 días gratis
  • Cancela cuando quieras
  • Solo APIs oficiales
  • Monitorizado 24/7

Verificado el