Crea una app de MatchaiPróximamente
Registra la app que los profesionales conectan con Conectar con Matchai: nombre, logo, sitio web, URL de redirección, ID y secreto, modo de prueba y quién paga.
Una app de Matchai es la forma en que tu producto aparece en Matchai. Cuando un profesional conecta su cuenta a tu creador de sitios web, a tu CRM o a tu asistente, la conecta a tu app de Matchai: esta lleva tu nombre y tu logo en la página de autorización, aparece después en su página Conectores y contiene el ID de cliente y el secreto de cliente que tu código usa para ejecutar el flujo OAuth.
¿Necesitas una?
| Estás creando | Necesitas |
|---|---|
| Un script o una herramienta para tu propia cuenta | Una clave de API. Ninguna app. |
| Un producto que usan otros profesionales, como un creador de sitios web, un CRM o la app de un socio | Una app de Matchai y Conectar con Matchai |
| Leer lo que los profesionales ya publicaron | Nada. Los recursos públicos no necesitan clave ni app. |
Los clientes MCP como Claude y ChatGPT no necesitan una app que registres tú: se registran solos cuando un profesional agrega Matchai. Consulta Clientes MCP.
Registra tu app
Abre Configuración → Conectores en Matchai, despliega Avanzado (para desarrolladores) y elige Crear una app de Matchai.
Completa los datos de la app:
Campo
Tipo
Guarda la app. Matchai te da un ID de cliente y un secreto de cliente.
Guarda el secreto en tu servidor, en un gestor de secretos o en una variable de entorno. Tu app ya está lista para iniciar el flujo de conexión.
ID de cliente y secreto de cliente
| Qué es | Dónde va | |
|---|---|---|
| ID de cliente | Identifica tu app. Aparece en la dirección de la página de autorización, así que no es secreto. | En la redirección a Matchai |
| Secreto de cliente | Demuestra que una solicitud viene realmente de tu app. | Solo en las llamadas del lado del servidor al endpoint de tokens. Nunca en código de navegador ni en una app móvil. |
Trata el secreto como una contraseña: mantenlo fuera de los repositorios, los registros y las capturas de pantalla.
URL de redirección
Después de que el profesional responde en la página de autorización, Matchai envía su navegador de vuelta a una de tus URL de redirección. Para que ese traspaso sea seguro:
- Registra cada dirección que usa tu app, incluida la que usas en tu propia computadora mientras desarrollas.
- Matchai sigue OAuth 2.1: una dirección de redirección debe coincidir exactamente con una registrada y debe usar
https. La excepción es una dirección de loopback comohttp://localhost:3000/matchai/callback, que se acepta mientras desarrollas. - Nunca aceptes la dirección de redirección desde un parámetro de la solicitud que cualquiera podría cambiar.
Modo de prueba
Puedes crear y probar antes de que se conecte ningún cliente, sin costo. Una app que está conectada solo a la cuenta de su propio desarrollador está en modo de prueba:
- No se factura. Conecta tu propia cuenta de Matchai a tu propia app tantas veces como quieras.
- Está marcada.
GET /v1/me/connectiondevuelvetest_mode: true, y los eventos que recibe tu endpoint de webhooks llevantest_mode: true. - Es una conexión real. Pasas por la misma página de autorización y obtienes el mismo tipo de tokens, alcances y aprobaciones que obtendrán tus clientes, así que puedes construir el flujo completo antes del lanzamiento.
Cuando otro profesional conecta tu app, esa conexión es real y se factura como se describe en quién paga.
Quién paga
Conectar una app a una cuenta es un conector de Matchai de pago, el mismo tipo de conexión que Claude o ChatGPT en la página Conectores. La unidad de facturación es una cuenta de Matchai conectada a una app. Una app que da servicio a tres profesionales tiene tres conexiones, sin importar cuántos tokens, webhooks o solicitudes haya detrás.
Cada app de Matchai tiene un ajuste quién paga:
| Ajuste | Lo que ve el profesional | A quién se le factura |
|---|---|---|
| Pagado por el usuario (el predeterminado) | La página de autorización dice que la conexión se agrega a su factura de Matchai. | Al profesional |
| Pagado por el socio | La página de autorización dice que la conexión está incluida con tu producto. | A ti, como socio |
El modo pagado por el socio es para socios verificados que tienen un acuerdo con Matchai. Si quieres pagar las conexiones de tus clientes, contacta al soporte de Matchai para conversarlo. Hasta entonces, tu app es pagada por el usuario, y la página de autorización se lo dice a cada profesional antes de que presione Permitir.
Matchai marca las apps cuyo editor verificó. GET /v1/me/connection devuelve app.verified.
Leer información pública, como los anuncios publicados de un profesional, nunca necesita una conexión y es gratis.
Por qué la página de autorización dice quién paga
Un profesional nunca debería llevarse una sorpresa con un cargo. Ve la consecuencia de precio de conectar tu app en el momento en que decide, junto a lo que la app puede hacer, y puede desconectarla en cualquier momento.
Qué sigue
Claves de APIPróximamente
Crea una clave de API con alcances para tu cuenta de Matchai, úsala como token bearer, protégela, rótala y revócala. Solo para tus scripts y herramientas de IA.
Conectar con MatchaiPróximamente
Conecta la cuenta de Matchai de un profesional a tu app con OAuth 2.1 y PKCE. Endpoints, la página de autorización, tokens y un ejemplo completo en TypeScript.