Engagerly 2.0 · Un flujo de trabajo claro para tu comunidad de Discord
API para desarrolladores

Conecta Engagerly con tus propios sistemas

Consulta y ajusta los saldos de los miembros y añade o quita roles desde tus apps, juegos y tiendas, con claves de API con ámbitos de permisos y un registro de auditoría completo.

Leer la documentación de la API

Premium+Premium y Ultimate pueden crear claves de API en el panel de control

REQUESTSuma 500 puntos a un miembro cuando haga un pedido.

curl -X POST "$API_BASE/v2/open/guilds/$GUILD_ID/points/adjust" \
  -H "X-API-Key: $ENGAGERLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "123456789012345678",
    "type": "add",
    "amount": 500,
    "note": "Order #1042 bonus",
    "ref": "order-1042"
  }'
USE CASES

Qué crean los equipos con ella

  • Recompensas en el juego

    Da puntos cuando los jugadores consigan logros en tu juego.

  • Bonos en tu tienda

    Recompensa a los clientes con puntos o un rol VIP cuando hagan un pedido.

  • Asistencia a eventos

    Da un rol a todos los que asistieron a un evento en directo o un webinar.

ENDPOINTS

Cuatro endpoints, limitados por permisos.

Cada clave se limita a los ámbitos de permisos que le concedas.

  • GET
    /v2/open/guilds/{guild_id}/points/balance/{user_id}

    Consulta el saldo de un miembro en cualquiera de las monedas del servidor.

    points:read
  • POST
    /v2/open/guilds/{guild_id}/points/adjust

    Suma o resta puntos a un miembro, con una nota opcional y tu propio ID de referencia.

    points:write
  • POST
    /v2/open/guilds/{guild_id}/members/{user_id}/roles/{role_id}

    Da un rol de Discord a un miembro.

    roles:write
  • DELETE
    /v2/open/guilds/{guild_id}/members/{user_id}/roles/{role_id}

    Quita un rol de Discord a un miembro.

    roles:write
KEYS & LIMITS

Claves y límites

  • Crea claves de API en el panel de control con Premium o Ultimate: hasta 10 por servidor.
  • Envía la clave en el encabezado X-API-Key. Cada clave solo funciona en su propio servidor.
  • Concede solo los ámbitos de permisos que necesite cada clave: points:read, points:write o roles:write.
  • Si quieres, define una fecha de vencimiento y una lista de IP permitidas para cada clave.
  • Cada clave permite 120 lecturas y 60 escrituras por minuto, cada servidor 200 llamadas por minuto, y cada llamada queda en el registro de auditoría de la clave.

¿Quieres ver qué viene después para la API?

Los nuevos endpoints se debaten primero en el servidor oficial de Discord.

Únete a nuestro servidor oficial de Discord
READY WHEN YOU ARE

¿Listo para que la participación
funcione sola?

Pruébalo como miembro