MCP Server e APIs da Velip
Conecte sua IA à Velip em 3 passos, sem código: cole um endereço, entre com sua conta e escolha o que ela pode fazer. Para sistemas próprios, use o MCP com token ou as APIs REST.
Já tem conta Velip? Conecte em 3 passos
Velip
Claude quer acessar sua conta Velip
Conectado como você, na conta da sua empresa
APIs que este aplicativo poderá usar
O uso consome o saldo da sua conta. Você muda as permissões ou revoga o acesso quando quiser.
Só autorize se foi você quem iniciou esta conexão agora.
Sem código e sem copiar token. Você só precisa de uma conta Velip.
Na tela de conexões do seu aplicativo de IA, adicione um conector com este endereço:
https://vox20.velip.com.br/mcpserver/velip A tela de login da Velip abre dentro do aplicativo. É a mesma senha que você usa na plataforma.
Marque SMS, WhatsApp, e-mail, telefonia ou base de destinos e autorize. A partir daí, é só pedir na conversa.
claude mcp add --transport http velip https://vox20.velip.com.br/mcpserver/velip Depois de conectar, você vê relatórios, cria campanhas, envia mensagens avulsas e consulta o saldo pela própria conversa.
São os mesmos cinco grupos da tela de autorização. Você libera só os que quiser e muda quando precisar.
Envia SMS pela plataforma Velip, com o texto que você pedir na conversa.
Tools send_sms
Envia texto, mídia ou templates aprovados pela API oficial da Meta, usando as suas linhas.
Tools send_whatsappget_wa_templatesget_wa_lines
Envia e-mail pela sua conta Gmail ou Microsoft 365, direto ou com os seus modelos e variáveis.
Tools send_emaillist_email_templates
Faz ligações com voz sintetizada, cria, clona e consulta campanhas e acompanha o status das chamadas.
Tools make_tts_callget_tts_voicescreate_campaignclone_campaignget_campaigns_listget_call_status
Cria a lista de telefones que uma campanha em lote vai usar.
Tools create_destination_base
Exemplos de pedidos feitos na conversa com o ChatGPT ou o Claude, depois de conectar.
Campanhas
Crie uma campanha de voz para os 300 clientes desta planilha, avisando que o boleto vence amanhã.
O que acontece
A IA cria a base de destinos com os telefones e monta a campanha com a mensagem em voz sintetizada.
create_destination_basecreate_campaign
Relatórios
Como foram as ligações da campanha de ontem? Monte uma tabela com atendidas e não atendidas.
O que acontece
A IA consulta a campanha e o status das chamadas e devolve a análise pronta na conversa.
get_campaigns_listget_call_status
Lembretes
Mande um WhatsApp para cada paciente desta planilha, lembrando o horário da consulta de amanhã.
O que acontece
A IA escolhe o template aprovado da sua linha e envia uma mensagem para cada contato.
get_wa_templatessend_whatsapp
Para cobrança, agendamento ou logística, seu agente combina os canais sozinho: lembrete no WhatsApp, ligação se não houver resposta e boleto por e-mail. É o mesmo MCP, conectado com token.
MCP é o formato que os agentes de IA usam para conversar com outros sistemas, sempre com uma IA de um dos lados. A Velip pode estar em qualquer uma das pontas.
Sua IA usa a Velip
O ChatGPT, o Claude ou o seu próprio agente se conecta à Velip e usa os canais para falar com seus clientes. A autorização é por login (OAuth) ou token, em Integrações → MCP Server.
Sua IA
ChatGPT, Claude, Cursor ou o seu próprio agente
Velip
MCP Server
Confere as permissões da conexão e executa o pedido
Seus clientes
Recebem a ligação, o WhatsApp, o SMS ou o e-mail
A Velip usa as suas ferramentas
Os agentes de IA de voz e texto da Velip se conectam a MCPs externos para buscar informações ou executar ações. A conexão é configurada no próprio agente.
Velip
Agente de IA
Atende seu cliente por voz ou por texto, inclusive no WhatsApp
Google Agenda
Ou outro sistema que ofereça MCP
Consulta marcada
O agente vê os horários livres e agenda durante a conversa
E muda de ideia quando quiser. Cada aplicativo conectado aparece na sua conta, com as próprias permissões.
Cada aplicativo tem os seus grupos liberados: SMS, WhatsApp, e-mail, telefonia e base de destinos. Você altera a qualquer momento.
Desative uma conexão para pausá-la ou revogue para cortar o acesso de vez. Um aplicativo revogado precisa de nova autorização para voltar.
O token tem 30 caracteres, aparece por completo só uma vez, na criação, e fica guardado com hash bcrypt, nunca em texto puro.
Por padrão, consultas por período ou campanha devolvem números mascarados (xxxxx877). O número completo só aparece se o token for configurado para isso.
MCP Server · Tokens
3Para o seu próprio agente ou para um cliente MCP sem login OAuth, gere um token em Integrações → MCP Server e escolha as permissões dele.
O token completo, de 30 caracteres, aparece só na criação. Se perder, revogue e gere outro.
Adicione ao .cursor/mcp.json do projeto (ou ao global, em ~/.cursor/mcp.json) e recarregue o Cursor.
{
"mcpServers": {
"velip": {
"url": "https://vox20.velip.com.br/mcpserver/velip",
"headers": {
"Authorization": "Bearer SEU_TOKEN"
}
}
}
}Execute no terminal, na pasta do projeto. Depois confira com "claude mcp list".
claude mcp add --transport http velip https://vox20.velip.com.br/mcpserver/velip --header "Authorization: Bearer SEU_TOKEN"Adicione ao claude_desktop_config.json (Configurações → Desenvolvedor → Editar configuração) e reinicie o app. Requer Node.js 18 ou superior.
{
"mcpServers": {
"velip": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://vox20.velip.com.br/mcpserver/velip",
"--header",
"Authorization:${VELIP_AUTH}"
],
"env": {
"VELIP_AUTH": "Bearer SEU_TOKEN"
}
}
}
}Teste rápido: lista as tools liberadas para este token. Só aparecem os grupos habilitados nas permissões.
curl -X POST 'https://vox20.velip.com.br/mcpserver/velip' \
-H 'Authorization: Bearer SEU_TOKEN' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Sem IA no meio: seu CRM, ERP ou aplicativo chama a Velip direto. Gere o token em Integrações → Tokens API.
Exemplos em PythonPHPNode.jscURLJava
Ligações com voz sintetizada ou áudio gravado
MakeTTSCallPlayAudioFileCreateAudioFileGetTTSVoices
Transferência para atendente humano
Gravação das ligações
Envio de SMS
MakeSMS
WhatsApp e templates
MakeWhatsappGetWATemplatesCreateWhatsappTemplateCheckTemplateStatusValidateWhatsAppNumber
Instagram e Messenger
MakeInstagramMakeMessenger
E-mail pela sua conta Gmail ou Microsoft 365
SendEmailOAuth
Campanhas e bases de destinos
CreateCampaignChangeCampaignGetCampaignsListCreateDestinationBase
Status e relatório das chamadas
GetCallStatus
Filas de atendimento
CreateCenterQueueGetCenterQueues
Chamadas pelo navegador (WebRTC)
GetWebRTC
curl --location --request POST 'https://vox.velip.com.br/api/v2/MakeTTSCall' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer SEU_TOKEN' \
--data-raw '{
"type": "0",
"content": "tf185409063",
"priority": "0",
"dest": "5511999999999",
"nome": "Maria Silva"
}'A API também aceita autenticação HTTP Basic, com usuário e senha.
Avisos e alertas por voz
Seu sistema dispara uma ligação quando algo acontece: pedido atrasado, pagamento confirmado, plantão acionado.
Códigos de verificação
Envie o código de acesso (2FA) por SMS ou por ligação, direto do seu login.
Ligação pelo site
Botão de ligar ou voicebot no seu site e aplicativo, com a conexão WebRTC da Velip.
Cliente e entregador sem expor números
Conecte cliente e entregador por uma ligação com número mascarado: nenhum dos dois vê o telefone do outro.
Não. Pelo login (OAuth), você só cola o endereço no aplicativo, entra com a sua conta Velip e escolhe as permissões.
Sim. Os envios feitos pela IA passam pela plataforma Velip e consomem o saldo da sua conta, como qualquer envio.
Sim. Cada aplicativo (Claude, ChatGPT, Cursor ou o seu sistema) vira uma conexão separada, com as próprias permissões, e pode ser pausado ou revogado sem afetar os outros.
Não. O token vale até você revogá-lo em Integrações → MCP Server. Se perder o token, revogue e gere outro: ele aparece completo só na criação.
No Claude.ai, no ChatGPT, no Claude Code e no Cursor, não. Só o Claude Desktop configurado com token precisa do Node.js 18 ou superior.
O MCP é feito para agentes de IA: a IA descobre sozinha o que pode fazer e escolhe a ação. As APIs REST são para sistemas que você programa, como um CRM ou ERP, com cada chamada definida no código.
Ecossistema Velip
Combine produtos especializados com a plataforma Velip One para automatizar comunicação, atendimento e processos.
Meta Business Partner Oficial
Conte o que a sua IA ou o seu sistema precisa fazer: ligações, WhatsApp, SMS ou e-mail. Nosso time indica o caminho, com MCP ou APIs REST.
Conte seu desafio. Nosso time indica o melhor caminho para sua operação.
Experimente falar com a Vel, nossa assistente de IA
Informe seu celular para um atendimento mais rápido