Saltar al contenido

Guía

Resumen de integraciones: API, webhooks y Zapier

Automatizaciones e integraciones · 4 min de lectura

Mateflow conecta tu comunidad con otras herramientas de tres formas: apps conectadas (Slack, Discord y Zapier), webhooks a tu propio servidor y la Open API para desarrolladores. Las tres están en una misma página de la consola de administración, Admin → Configuración → Integraciones.

Quién puede hacerlo: los propietarios y administradores. · Dónde: web (consola de administración). · Plan: los webhooks, el acceso a la API y el límite diario de solicitudes a la API dependen de tu plan de la plataforma.

Dónde encontrar las integraciones en la consola de administración

Ve a Admin → Configuración → Integraciones. La página se llama Integraciones y API y tiene cuatro pestañas:

Pestaña Qué haces en ella
Integraciones Conectar Slack, Discord o Zapier en Apps conectadas
Webhooks Enviar eventos de la comunidad a tu propio endpoint
Acceso a la API Crear y revocar claves de API, y abrir la documentación para desarrolladores
Registros de entrega Revisar cada solicitud que Mateflow envió a tus webhooks, apps y reglas de automatización

Conectar Slack, Discord o Zapier

Las apps conectadas envían eventos de la comunidad, como nuevos miembros, publicaciones o pagos, a otro servicio:

  • Slack: publica mensajes en un canal mediante una URL de Incoming Webhook.
  • Discord: publica mensajes en un canal mediante una URL de webhook de Discord. Solo envía mensajes; no sincroniza miembros ni roles.
  • Zapier: envía eventos a un Catch Hook de Zapier, para que un Zap pueda pasarlos a miles de otras apps.

Para conectar una, abre la pestaña Integraciones y haz clic en Conectar Slack, Conectar Discord o Conectar Zapier. Pega la URL del webhook de ese servicio, elige los Eventos a enviar, añade si quieres una Clave de firma (opcional) y haz clic en Conectar. Después haz clic en Enviar evento de prueba para comprobar que los mensajes llegan.

La tarjeta de una app conectada muestra qué eventos envía. Usa su menú para Editar ajustes, Enviar evento de prueba o Desconectar.

Enviar eventos a tu propio servidor con webhooks

Los webhooks envían una solicitud HTTPS a un endpoint que controlas cada vez que ocurre un evento elegido, por ejemplo Miembro se unió, Miembro añadido a un grupo de acceso, Publicación creada o Pago recibido. Cada webhook tiene sus propios eventos, una clave de firma opcional y un interruptor Activo. Los webhooks, y cuántos puedes crear, dependen de tu plan de la plataforma. Consulta Configurar webhooks.

Crear tu propia integración con la Open API

La Open API permite que un desarrollador lea y escriba los datos de tu comunidad desde su propio código: leer publicaciones, espacios y miembros, crear publicaciones, subir archivos multimedia e invitar a personas. Cada clave de API pertenece a una sola comunidad, y eliges sus permisos (scopes) al crearla. Las claves de API no se gestionan en el panel de creador (app.mateflow.com); su página Resumen de la comunidad enlaza a esta página de la consola de administración.

Las invitaciones enviadas mediante la API pueden incluir grupos de acceso, que la persona recibe al aceptar. Consulta Cómo funcionan los grupos de acceso.

La referencia completa de la API está en mateflow.com/developers. En la pestaña Acceso a la API, haz clic en Abrir documentación para llegar ahí y envía el enlace a tu desarrollador; no necesita una cuenta en tu comunidad. Consulta Crear una clave de API.

Revisar las solicitudes salientes en Registros de entrega

La pestaña Registros de entrega muestra las solicitudes salientes enviadas por tus webhooks, tus apps conectadas y las reglas de automatización que usan Trigger webhook. Filtra por Tipo de evento, resultado y fecha, y haz clic en Ver detalles para ver la solicitud y la respuesta completas. Los registros de entrega se conservan 30 días. Las entregas de webhook fallidas se reintentan automáticamente; no hay ningún botón para reenviar una tú mismo.

Las solicitudes hechas con tus claves de API no se registran aquí. En su lugar, la pestaña Acceso a la API muestra la fecha de Último uso de cada clave.

Artículos relacionados

¿Te resultó útil esta guía?

Volver a las guías

¿No encuentras lo que necesitas?

Si eres miembro de una comunidad, sus administradores son quienes pueden ayudarte. Si estás creando o gestionando una en Mateflow, nuestro equipo puede ayudarte.

Empezar gratis