API multitenant para redes sociales: una clave API, las cuentas de muchos clientes
La Partner API de easyCoexistence es multitenant por diseño: una clave ec_live_ en tu cuenta conecta y gestiona los números de WhatsApp y las cuentas sociales de muchos clientes. Cada conexión lleva el id de tu cliente como external_ref, guarda el token propio de ese cliente, tiene su propio destino de webhook y aparece en los eventos de estado firmados, de modo que GET /channels?external_ref= lista las cuentas de un solo cliente.
Longitud máxima de external_ref que acepta una sesión de conexión: el id propio del cliente, guardado en la conexión que crea.
Claves API que puede tener una cuenta de easyCoexistence a la vez; claves separadas significan cuentas separadas con facturas separadas.
Sesiones de conexión que una cuenta puede tener abiertas a la vez, junto con un límite de 100 sesiones nuevas por hora.
Antigüedad a partir de la cual debe rechazarse la marca de tiempo de un evento firmado, comparando el HMAC en tiempo constante.
¿Cómo sirve una sola cuenta a muchos clientes?
Tu cuenta de easyCoexistence representa tu producto, y cada cliente es una etiqueta en las conexiones que aporta. Los clientes no crean cuenta propia, nunca ven tu clave y los factura tu empresa, no easyCoexistence:
¿Cómo etiquetas cada conexión con tu cliente?
Envía external_ref en la sesión de conexión. El valor se guarda en el número o canal que crea la sesión, se añade a la redirección y se incluye en sus eventos de estado. Un inicio de sesión de Facebook o LinkedIn que trae varias páginas etiqueta cada una. Para ver las cuentas de un cliente, filtra cualquiera de las dos listas:
curl "https://easycoexistence.com/api/v1/channels?external_ref=customer_4821" \
-H "Authorization: Bearer $EC_API_KEY"
curl "https://easycoexistence.com/api/v1/connections?external_ref=customer_4821" \
-H "Authorization: Bearer $EC_API_KEY"¿Cómo se mantienen separados los tokens de los clientes?
Cada conexión guarda el token de su propio cliente. El token de un número de WhatsApp es el token de negocio que Meta emite en Embedded Signup, limitado a los activos de ese cliente, y el token de una cuenta social es el que concedió su propietario. Las credenciales salen solo a través de tu clave, desde tu backend, y un ID que no está en tu cuenta responde 404 not_found. Busca la conexión del cliente al que pertenece un trabajo antes de obtener su token, para que el trabajo de un cliente nunca se ejecute en la cuenta de otro.
¿Cómo funcionan los webhooks por cliente?
Un destino por cuenta, que tú eliges. Apunta los canales a una sola URL y enruta según account_id en el cuerpo, o asigna a cada cliente una URL propia. Cada canal firma con su propio secreto desde PUT /channels/{id}/webhook, así que account_id indica con qué secreto verificar. Los mensajes de un número van de Meta a su webhook_url, configurada en la WhatsApp Business Account, así que enrútalos por phone_number_id.
¿Cómo indican los eventos de estado a qué cliente pertenecen?
Llevando tu external_ref. Una URL de eventos por cuenta recibe los eventos connection.* y channel.*, cada uno con la vista de la conexión o del canal dentro, incluido external_ref, y post.published y post.failed traen la publicación y su canal. Los eventos se firman con el secreto propio de la cuenta en X-EC-Signature y se reintentan cuando tu endpoint falla, así que procesa cada id de entrega una sola vez.
¿Qué tan rápido puedes incorporar a muchos clientes?
A 50 sesiones de conexión abiertas y 100 nuevas por hora por cuenta. Meta cuenta cada alta de WhatsApp por primera vez contra un límite de toda la aplicación que comparten todas las cuentas de easyCoexistence, y los topes evitan que la importación de una plataforma lo agote. Crea cada sesión cuando su cliente está a punto de conectarse; un tope responde 429 cap_reached o rate_limited.
¿Qué pasa si la cuenta de un cliente ya está conectada en otro lugar?
El inicio de sesión se rechaza. Una cuenta social se conecta a través de una cuenta de easyCoexistence a la vez, así que si otro servicio que usa easyCoexistence la tiene, el last_error de la sesión lo indica y el cliente la quita allí o inicia sesión con otra cuenta. Dentro de tu propia cuenta, un cliente puede conectar tantas cuentas como necesite, cada una etiquetada con el mismo external_ref.
¿Cómo das de baja a un cliente?
Lista sus conexiones y canales por external_ref y haz DELETE de cada uno. Quitar un número revoca el acceso de easyCoexistence en Meta y detiene el monitoreo; quitar un canal revoca el acceso en la red y cancela sus publicaciones que aún esperan en la cola. La facturación de cada una se detiene al final del ciclo, y las demás conexiones del cliente, como las de otros clientes, no se tocan.
Errores comunes
- Usar un email como external_ref. Los emails cambian y el valor se guarda en cada conexión, así que usa el id estable de tu propia base de datos.
- Verificar los eventos reenviados con el secreto de otro cliente. Busca el secreto por el account_id del cuerpo, ya que cada canal firma con el suyo.
- Enviar enlaces de conexión a toda tu base de clientes a la vez. Solo pueden abrirse 50 sesiones por cuenta, así que invita a los clientes en oleadas.
- Dar de baja a un cliente solo en tu base de datos. Sus conexiones siguen en tu cuenta y en tu factura hasta que cada una se elimina mediante la API.
easyCoexistence permite que una clave API atienda a toda tu base de clientes: sus números de WhatsApp y sus cuentas de Instagram, Facebook, TikTok, YouTube y LinkedIn, y más canales, cada uno etiquetado con el id de tu cliente, con su propio token, webhook y eventos firmados, y cada conexión monitoreada 24/7. El precio va de US$ 9 a US$ 0.75 por conexión al mes y baja a medida que añades conexiones, con los primeros 3 días gratis.
Preguntas frecuentes
¿Necesito una cuenta de easyCoexistence por cliente?
No. Una cuenta y su clave pueden tener las conexiones de muchos clientes, diferenciadas por external_ref. Solo hacen falta cuentas separadas si quieres facturas separadas.
¿Pueden mis clientes ver las cuentas de otros?
No a través de easyCoexistence. Nunca tienen tu clave y solo abren sus propios enlaces de conexión. Lo que cada cliente ve dentro de tu producto lo decide tu código.
¿Puedo dar a cada cliente una URL de webhook distinta?
Sí. Cada número y cada canal admite su propio destino, así que funciona una URL específica por cliente, como también una URL compartida enrutada por account_id.
¿Cómo se factura una cuenta multitenant?
Por conexión en el total de todos tus clientes: de US$ 9 a US$ 0.75 por conexión al mes, según el tramo de tu recuento total, con 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