API Tutorial
Cómo enviar mensajes de Snapchat por API
Para enviar mensajes de Snapchat por API, conecta Snapchat a través de Modiva y luego llama a `messages_send` con el destinatario y el texto — lee la conversación con `messages_list` para impulsar bandejas de entrada y respuestas automáticas con IA.
La mensajería programática en Snapchat suele implicar abrirse paso entre APIs de mensajería específicas de cada plataforma y sus aprobaciones. Modiva lo abstrae en `messages_send`, `messages_list` y `messages_inbox`, de modo que una bandeja de entrada unificada o un respondedor de IA funcionan en Snapchat igual que en cualquier otro sitio.
Paso a paso
Crea una cuenta de Modiva y una clave MCP
Regístrate gratis y genera una clave MCP (`mk_live_…`) en el panel. La misma clave autentica tanto el servidor MCP alojado (para agentes de IA) como la API REST (para tu backend), así que solo gestionas una credencial.
Conecta tu cuenta de Snapchat
En el panel, haz clic en Conectar y elige Snapchat. Modiva ejecuta el flujo de OAuth y solicita los scopes adecuados por ti, luego guarda los tokens de acceso y de actualización en una bóveda cifrada y los mantiene al día — nunca manipulas las credenciales de API sin procesar de Snapchat. La conexión recibe un `connectionId` estable al que haces referencia en cada llamada.
Envía un mensaje con messages_send
Llama a `messages_send` con el ID de conexión, un `recipient_id` y tu texto. Modiva lo entrega a través de Snapchat y devuelve el ID del mensaje, respetando las ventanas y reglas de mensajería de Snapchat.
Construye una bandeja de entrada o un respondedor de IA
Usa `messages_inbox` y `messages_list` para traer las conversaciones a una sola vista. A través de MCP, un agente puede leer un mensaje entrante de Snapchat, decidir una respuesta y contestar con `messages_send` — un ciclo completo de soporte con IA.
Solicitud de ejemplo
Llama a la herramienta messages_send a través de la API REST de Modiva. La misma herramienta está disponible para los agentes de IA en el servidor MCP en https://mcp.modiva.ai/v1.
curl -X POST https://api.modiva.ai/v1/tools/invoke \
-H "Authorization: Bearer mk_live_…" \
-H "Content-Type: application/json" \
-d '{
"tool": "messages_send",
"connectionId": "conn_…",
"args": { "recipient_id": "u_456", "text": "Hi! How can we help today?" }
}'Pruébalo con Snapchat
Empieza gratisPreguntas frecuentes
¿Puedo construir una bandeja de entrada unificada que incluya Snapchat?
Sí. `messages_inbox` devuelve las conversaciones de Snapchat en la misma forma que cualquier otro canal, de modo que una única interfaz de bandeja de entrada las cubre todas.
¿Respeta Modiva las reglas de mensajería de Snapchat?
Sí — Modiva aplica las ventanas de mensajería y los requisitos de política de Snapchat, para que tus envíos sigan siendo conformes.