MCP Server y APIs de Velip
Conecta tu IA a Velip en 3 pasos, sin código: pega una dirección, inicia sesión con tu cuenta y elige qué puede hacer. Para sistemas propios, usa el MCP con token o las APIs REST.
¿Ya tienes cuenta Velip? Conecta en 3 pasos
Velip
Claude quiere acceder a tu cuenta Velip
Conectado como tú, en la cuenta de tu empresa
APIs que esta aplicación podrá usar
El uso consume el saldo de tu cuenta. Cambia los permisos o revoca el acceso cuando quieras.
Autoriza solo si fuiste tú quien inició esta conexión ahora.
Sin código y sin copiar token. Solo necesitas una cuenta Velip.
En la pantalla de conexiones de tu aplicación de IA, agrega un conector con esta dirección:
https://vox20.velip.com.br/mcpserver/velip La pantalla de inicio de sesión de Velip se abre dentro de la aplicación. Es la misma contraseña de la plataforma.
Marca SMS, WhatsApp, e-mail, telefonía o base de destinos y autoriza. Desde ahí, solo pídelo en la conversación.
claude mcp add --transport http velip https://vox20.velip.com.br/mcpserver/velip Después de conectar, ves informes, creas campañas, envías mensajes sueltos y consultas el saldo desde la propia conversación.
Son los mismos cinco grupos de la pantalla de autorización. Liberas solo los que quieras y los cambias cuando lo necesites.
Envía SMS por la plataforma Velip, con el texto que pidas en la conversación.
Tools send_sms
Envía texto, multimedia o plantillas aprobadas por la API oficial de Meta, usando tus líneas.
Tools send_whatsappget_wa_templatesget_wa_lines
Envía e-mail desde tu cuenta de Gmail o Microsoft 365, directo o con tus plantillas y variables.
Tools send_emaillist_email_templates
Hace llamadas con voz sintetizada, crea, clona y consulta campañas y sigue el estado de las llamadas.
Tools make_tts_callget_tts_voicescreate_campaignclone_campaignget_campaigns_listget_call_status
Crea la lista de teléfonos que usará una campaña en lote.
Tools create_destination_base
Ejemplos de pedidos hechos en la conversación con ChatGPT o Claude, después de conectar.
Campañas
Crea una campaña de voz para los 300 clientes de esta planilla, avisando que la factura vence mañana.
Qué pasa
La IA crea la base de destinos con los teléfonos y arma la campaña con el mensaje en voz sintetizada.
create_destination_basecreate_campaign
Informes
¿Cómo fueron las llamadas de la campaña de ayer? Arma una tabla con atendidas y no atendidas.
Qué pasa
La IA consulta la campaña y el estado de las llamadas y devuelve el análisis listo en la conversación.
get_campaigns_listget_call_status
Recordatorios
Envía un WhatsApp a cada paciente de esta planilla, recordando el horario de la cita de mañana.
Qué pasa
La IA elige la plantilla aprobada de tu línea y envía un mensaje a cada contacto.
get_wa_templatessend_whatsapp
Para cobranza, agendamiento o logística, tu agente combina los canales solo: recordatorio por WhatsApp, llamada si no hay respuesta y la factura por e-mail. Es el mismo MCP, conectado con token.
MCP es el formato que usan los agentes de IA para hablar con otros sistemas, siempre con una IA de un lado. Velip puede estar en cualquiera de los extremos.
Tu IA usa Velip
ChatGPT, Claude o tu propio agente se conecta a Velip y usa sus canales para hablar con tus clientes. La autorización es por inicio de sesión (OAuth) o token, en Integraciones → MCP Server.
Tu IA
ChatGPT, Claude, Cursor o tu propio agente
Velip
MCP Server
Verifica los permisos de la conexión y ejecuta el pedido
Tus clientes
Reciben la llamada, el WhatsApp, el SMS o el e-mail
Velip usa tus herramientas
Los agentes de IA de voz y texto de Velip se conectan a MCPs externos para buscar información o ejecutar acciones. La conexión se configura en el propio agente.
Velip
Agente de IA
Atiende a tu cliente por voz o por texto, incluso en WhatsApp
Google Calendar
U otro sistema que ofrezca MCP
Cita agendada
El agente ve los horarios libres y agenda durante la conversación
Y cambias de idea cuando quieras. Cada aplicación conectada aparece en tu cuenta, con sus propios permisos.
Cada aplicación tiene sus grupos liberados: SMS, WhatsApp, e-mail, telefonía y base de destinos. Los cambias en cualquier momento.
Desactiva una conexión para pausarla o revócala para cortar el acceso del todo. Una aplicación revocada necesita una nueva autorización para volver.
El token tiene 30 caracteres, se muestra completo una sola vez, al crearlo, y se guarda con hash bcrypt, nunca en texto plano.
Por defecto, las consultas por período o campaña devuelven números enmascarados (xxxxx877). El número completo solo aparece si el token está configurado para eso.
MCP Server · Tokens
3Para tu propio agente o para un cliente MCP sin inicio de sesión OAuth, genera un token en Integraciones → MCP Server y elige sus permisos.
El token completo, de 30 caracteres, se muestra solo al crearlo. Si lo pierdes, revócalo y genera otro.
Agrégalo al .cursor/mcp.json del proyecto (o al global, en ~/.cursor/mcp.json) y recarga Cursor.
{
"mcpServers": {
"velip": {
"url": "https://vox20.velip.com.br/mcpserver/velip",
"headers": {
"Authorization": "Bearer TU_TOKEN"
}
}
}
}Ejecútalo en la terminal, en la carpeta del proyecto. Después verifica con "claude mcp list".
claude mcp add --transport http velip https://vox20.velip.com.br/mcpserver/velip --header "Authorization: Bearer TU_TOKEN"Agrégalo a claude_desktop_config.json (Configuración → Desarrollador → Editar configuración) y reinicia la app. Requiere Node.js 18 o superior.
{
"mcpServers": {
"velip": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://vox20.velip.com.br/mcpserver/velip",
"--header",
"Authorization:${VELIP_AUTH}"
],
"env": {
"VELIP_AUTH": "Bearer TU_TOKEN"
}
}
}
}Prueba rápida: lista las tools liberadas para este token. Solo aparecen los grupos habilitados en sus permisos.
curl -X POST 'https://vox20.velip.com.br/mcpserver/velip' \
-H 'Authorization: Bearer TU_TOKEN' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Sin IA en el medio: tu CRM, ERP o aplicación llama a Velip directamente. Genera el token en Integraciones → Tokens API.
Ejemplos en PythonPHPNode.jscURLJava
Llamadas con voz sintetizada o audio grabado
MakeTTSCallPlayAudioFileCreateAudioFileGetTTSVoices
Transferencia a un agente humano
Grabación de las llamadas
Envío de SMS
MakeSMS
WhatsApp y plantillas
MakeWhatsappGetWATemplatesCreateWhatsappTemplateCheckTemplateStatusValidateWhatsAppNumber
Instagram y Messenger
MakeInstagramMakeMessenger
E-mail desde tu cuenta de Gmail o Microsoft 365
SendEmailOAuth
Campañas y bases de destinos
CreateCampaignChangeCampaignGetCampaignsListCreateDestinationBase
Estado e informe de las llamadas
GetCallStatus
Colas de atención
CreateCenterQueueGetCenterQueues
Llamadas desde el navegador (WebRTC)
GetWebRTC
curl --location --request POST 'https://vox.velip.com.br/api/v2/MakeTTSCall' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer TU_TOKEN' \
--data-raw '{
"type": "0",
"content": "tf185409063",
"priority": "0",
"dest": "5511999999999",
"nome": "Maria Silva"
}'La API también acepta autenticación HTTP Basic, con usuario y contraseña.
Avisos y alertas por voz
Tu sistema hace una llamada cuando algo pasa: pedido atrasado, pago confirmado, guardia activada.
Códigos de verificación
Envía el código de acceso (2FA) por SMS o por llamada, directo desde tu inicio de sesión.
Llamadas desde tu sitio
Botón de llamar o voicebot en tu sitio y aplicación, con la conexión WebRTC de Velip.
Cliente y repartidor sin exponer números
Conecta cliente y repartidor con una llamada de número enmascarado: ninguno ve el teléfono del otro.
No. Con el inicio de sesión (OAuth), solo pegas la dirección en la aplicación, entras con tu cuenta Velip y eliges los permisos.
Sí. Los envíos hechos por la IA pasan por la plataforma Velip y consumen el saldo de tu cuenta, como cualquier envío.
Sí. Cada aplicación (Claude, ChatGPT, Cursor o tu sistema) es una conexión separada, con sus propios permisos, y se puede pausar o revocar sin afectar a las demás.
No. El token vale hasta que lo revoques en Integraciones → MCP Server. Si lo pierdes, revócalo y genera otro: se muestra completo solo al crearlo.
En Claude.ai, ChatGPT, Claude Code y Cursor, no. Solo Claude Desktop configurado con token necesita Node.js 18 o superior.
El MCP está hecho para agentes de IA: la IA descubre sola qué puede hacer y elige la acción. Las APIs REST son para sistemas que tú programas, como un CRM o ERP, con cada llamada definida en el código.
Ecosistema Velip
Combina productos especializados con la plataforma Velip One para automatizar comunicación, atención y procesos.
Meta Business Partner Oficial
Cuéntanos qué necesita hacer tu IA o tu sistema: llamadas, WhatsApp, SMS o e-mail. Nuestro equipo te indica el camino, con MCP o APIs REST.
Cuéntanos tu desafío. Nuestro equipo te recomendará el mejor camino para tu operación.
Prueba hablar con Vel, nuestra asistente de IA
Informe seu celular para um atendimento mais rápido