Marketing
SurveyMonkey en tu producto y en tus agentes de IA, con una API
El toolkit de SurveyMonkey cubre encuestas y carpetas, colectores (enlaces web e invitaciones por email), respuestas individuales y resúmenes por pregunta. Tu cliente conecta SurveyMonkey una vez con OAuth, y tu producto o agente de IA llama a cada operación a través de Connect, que guarda y renueva las credenciales y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/surveymonkey_create_survey/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"title": "<title>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a SurveyMonkey.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de SurveyMonkey. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con SurveyMonkey.
Lanza una encuesta desde tu app
Crea una encuesta con sus páginas y preguntas, agrega un colector weblink y comparte la url con tus usuarios.
Lleva respuestas a tu producto
Lista las respuestas de una encuesta con simple en true y envía las respuestas a tu CRM o analítica a medida que llegan.
Agente resume los resultados
Un agente de IA lee Listar resúmenes de la encuesta y Obtener encuesta para explicar cuántas personas eligieron cada respuesta, usando los ids de las preguntas.
Tools
11 tools de SurveyMonkey
- Listar encuestasGETLista las encuestas que la cuenta posee o que se compartieron con ella, con id, título y nickname; include agrega conteos, fechas y enlaces. Pagina con page mientras la respuesta tenga links.next.
- Listar carpetas de encuestasGETLista las carpetas de encuestas de la cuenta con id, título y número de encuestas. Pagina con page mientras la respuesta tenga links.next.
- Obtener encuestaGETDevuelve la encuesta completa: configuración, los enlaces de edición, vista previa, recolección y análisis, y cada página con sus preguntas y opciones de respuesta, todos con sus ids. Las herramientas de respuestas y Listar resúmenes de la encuesta se refieren a estos ids.
- Crear encuestaPOSTCrea una encuesta: vacía, copiada de otra encuesta con from_survey_id, o con sus páginas y preguntas en pages. Devuelve el id de la encuesta y sus enlaces de edición, vista previa y recolección. Aún necesita un colector para recibir respuestas.
- Actualizar encuestaPATCHCambia el título, nickname, idioma, textos de los botones, variables personalizadas, pie de página o carpeta de una encuesta. Las páginas y preguntas quedan como están.
- Listar colectoresGETLista los colectores de una encuesta, las formas en que recibe respuestas, como un enlace web o una invitación por email, con id y nombre; include agrega type, status, url y response_count. Pagina con page mientras la respuesta tenga links.next.
- Crear colectorPOSTCrea un colector para una encuesta. Un colector weblink devuelve el enlace para compartir en url, y es el único tipo que puede crear el plan gratuito. Un colector email solo prepara la invitación: destinatarios y envío quedan en SurveyMonkey.
- Actualizar colectorPATCHCambia un colector: lo cierra o lo reabre con status, o cambia su nombre, fecha de cierre, límite de respuestas, mensajes y redirección.
- Listar respuestasGETLista las respuestas de una encuesta con todas las respuestas dadas, como ids de pregunta, opción y fila, más los textos cuando simple es true. En el plan gratuito solo vuelven las primeras 25 respuestas de cada encuesta, y pedir más devuelve el error 1005. Pagina con page mientras la respuesta tenga links.next.
- Obtener respuestaGETDevuelve una respuesta con todas las respuestas dadas, su estado, horarios, colector y los datos del encuestado que guarda el colector.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/surveymonkey, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
Preguntas sobre el toolkit de SurveyMonkey
¿Necesito implementar la API de SurveyMonkey?
No. Connect ya trae 11 tools de SurveyMonkey descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de SurveyMonkey?
Con el modo que acepta el toolkit: OAuth con la app de tu producto. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
