Telinfy MCP server

oficial

Send SMS, WhatsApp, and RCS messages programmatically with DLT compliance. Manage contacts, schedule campaigns, and track delivery reports.

GitHub

Documentação

Guia de Integração do Telinfy MCP

Como conectar e usar o servidor Telinfy MCP com assistentes de IA

O servidor Telinfy MCP fornece acesso programático às capacidades de mensagens SMS, WhatsApp e RCS da Telinfy, permitindo que assistentes de IA enviem mensagens, gerenciem contatos, agendem campanhas e recuperem relatórios em seu nome.

O que é MCP?

O Model Context Protocol (MCP) é um padrão aberto que permite que aplicações de IA se conectem de forma segura a fontes de dados e ferramentas compatíveis com MCP. Pense no MCP como uma porta USB-C para aplicações de IA - uma forma padronizada de conectar aplicações de IA a diferentes serviços.

Servidor Telinfy MCP

O servidor Telinfy MCP é um serviço seguro e autenticado que fornece acesso à sua plataforma de mensagens Telinfy.

URL Base do Servidor: https://mcp.telinfy.com/sse

Autenticação Necessária

Para usar o servidor Telinfy MCP, você precisa de:

  • Nome de usuário Telinfy
  • Senha Telinfy
  • Credenciais de API (recuperadas automaticamente após o login)

Ferramentas Disponíveis

O servidor Telinfy MCP oferece ferramentas abrangentes de mensagens e gerenciamento de campanhas:

Operações de SMS

  1. send_sms - Enviar mensagens SMS com conformidade DLT
  2. schedule_sms - Agendar campanhas de SMS para entrega futura
  3. scheduleDynamicCampaign - Agendar campanhas dinâmicas de SMS usando arquivos Excel e variáveis de modelo
  4. get_sms_schedule - Visualizar todas as campanhas de SMS agendadas
  5. fetch_sms_campaign_report - Obter relatórios detalhados de campanhas de SMS

Operações do WhatsApp

  1. send_whatsapp_campaign - Enviar mensagens do WhatsApp usando modelos pré-criados
  2. whatsapp_campaign - Listar todas as campanhas do WhatsApp
  3. fetch_whatsapp_smart_report - Obter relatórios de campanhas do WhatsApp com filtro por data

Operações de RCS

  1. fetch_rcs_report - Recuperar relatórios de mensagens RCS com filtro por data

Gerenciamento de Contatos

  1. create_phonebook - Criar novos grupos de lista telefônica com contatos
  2. get_phonebook_groups - Listar todos os grupos de lista telefônica
  3. get_group_contacts - Visualizar contatos dentro de um grupo específico
  4. edit_contact - Atualizar informações de contato
  5. toggle_contact_status - Habilitar/desabilitar contatos em um grupo
  6. delete_contact_group - Remover grupos de lista telefônica

Relatórios de Mensagens

  1. getMessageReport - Buscar relatórios de entrega de mensagens e status para mensagens enviadas

Autenticação

  1. login_to_telinfy - Autenticar e estabelecer uma sessão com a plataforma Telinfy

Protocolo de Comunicação

O servidor Telinfy MCP usa o protocolo SSE (Server-Sent Events):

SSE (Server-Sent Events) - /sse

  • URL: https://mcp.telinfy.com/sse
  • A versão oficial da especificação MCP
  • Suportado por Claude, Windsurf, Cursor e outros clientes MCP
  • Recomendado para todas as integrações

Instruções de Configuração

Para Claude Desktop/Web:

  1. Vá para as configurações do Claude
  2. Navegue até "Integrações" ou "Conexões"
  3. Adicione um novo servidor MCP com estes detalhes:
    • Nome: Telinfy
    • URL do Servidor: https://mcp.telinfy.com/sse
  4. Salve a configuração

Para Claude Code (Linha de Comando):

claude mcp add -s user -t http telinfy https://mcp.telinfy.com/sse

Para Windsurf, Cursor ou outros clientes MCP:

Adicione esta configuração ao seu arquivo de configurações MCP:

{ "mcpServers": { "telinfy": { "serverUrl": "https://mcp.telinfy.com/sse" } } }

Usando o Telinfy MCP

Configuração Inicial

Após conectar o servidor MCP, você precisará autenticar com suas credenciais Telinfy:

Claude, please log me into Telinfy using my username and password.

O assistente de IA usará a ferramenta login_to_telinfy para estabelecer uma sessão segura.

Exemplos de Casos de Uso

Enviar uma Campanha de SMS

Send an SMS to +919876543210 with the message "Your OTP is 123456" 
using sender name "NOTIFY" and template ID "1234567890"

Agendar uma Campanha de Marketing

Schedule an SMS campaign named "Weekend Sale" to be sent tomorrow at 10 AM 
to these numbers: +919876543210, +919876543211 with the message 
"Flash Sale this weekend! 50% off. Visit now."

Criar um Grupo de Contatos

Create a new phonebook group called "VIP Customers" with these contacts:
- John Doe, +919876543210
- Jane Smith, +919876543211

Enviar Mensagens do WhatsApp

Send a WhatsApp campaign using my "order_confirmation" template 
to +919876543210 with customer name "John" and order number "ORD123"

Obter Relatórios de Campanhas

Show me the SMS campaign report for campaign ID "12345"

Buscar Status de Entrega de Mensagens

Get the delivery status for all messages sent today

Principais Recursos

Conformidade DLT

Todas as campanhas de SMS suportam conformidade DLT (Distributed Ledger Technology) com IDs de modelo e nomes de remetente, garantindo conformidade regulatória na Índia.

Campanhas Dinâmicas

Agende campanhas de SMS personalizadas usando arquivos Excel com substituição de variáveis, perfeito para mensagens em massa personalizadas.

Mensagens Multicanal

  • SMS - Rotas promocionais e transacionais
  • WhatsApp - Mensagens comerciais baseadas em modelos
  • RCS - Serviços de Comunicação Avançada

Relatórios Abrangentes

Acompanhe a entrega de mensagens, o desempenho da campanha e gere relatórios detalhados com filtro por data.

Organize contatos em grupos, habilite/desabilite contatos e mantenha listas telefônicas limpas.

Segurança e Autenticação

  • Todas as chamadas de API são autenticadas usando suas credenciais Telinfy
  • Autenticação segura baseada em token após o login inicial
  • As sessões são mantidas durante a sua conversa
  • Nenhuma credencial é armazenada pelo assistente de IA

Suporte e Recursos

Solução de Problemas

Problemas de Autenticação

Se você encontrar problemas de login:

  1. Verifique se seu nome de usuário e senha estão corretos
  2. Verifique se sua conta tem acesso à API habilitado
  3. Entre em contato com o suporte Telinfy para garantir que sua conta tenha acesso MCP

Problemas de Conexão

Se o servidor MCP não conectar:

  1. Verifique se a URL do servidor está exatamente: https://mcp.telinfy.com/sse
  2. Verifique sua conexão com a internet
  3. Tente reconectar o servidor MCP nas configurações do seu cliente de IA

Problemas de Entrega de Mensagens

Se as mensagens não estiverem sendo enviadas:

  1. Certifique-se de ter créditos suficientes em sua conta Telinfy
  2. Verifique se os IDs de modelo DLT estão registrados corretamente
  3. Verifique se os nomes de remetente estão aprovados em sua conta Telinfy
  4. Confirme se os números de telefone estão no formato correto

Melhores Práticas

  1. Sempre faça login primeiro - Autentique no início de cada sessão
  2. Use IDs de modelo corretos - Certifique-se de que os modelos DLT correspondam ao conteúdo da sua mensagem
  3. Verifique os formatos de telefone - Use números indianos de 10 dígitos ou formato internacional com código do país
  4. Verifique os relatórios de campanha - Monitore o status de entrega regularmente
  5. Gerencie contatos de forma eficiente - Mantenha os grupos da lista telefônica organizados
  6. Teste antes do envio em massa - Envie mensagens de teste antes de grandes campanhas

Exemplo de Fluxo de Trabalho

Aqui está um fluxo de trabalho completo para enviar uma campanha:

  1. Autenticar
Log me into Telinfy with username "myuser" and password "mypass"
  1. Criar Grupo de Contatos
Create a phonebook group "Spring Sale 2024" with my customer list
  1. Agendar Campanha
Schedule an SMS campaign "Spring Sale Announcement" to the "Spring Sale 2024"  
group for tomorrow at 9 AM with message "Exclusive Spring Sale! 40% off all items.  
Shop now at example.com" using sender "RETAIL" and template "1234567890"
  1. Monitorar Resultados
Show me the delivery report for the Spring Sale campaign

Recursos Avançados

Substituição Dinâmica de Variáveis

Use arquivos Excel para enviar mensagens personalizadas em escala:

  • Carregue o Excel com colunas: Celular, Nome, IDPedido, Valor
  • Mapeie variáveis: {{1}} = Nome, {{2}} = IDPedido, {{3}} = Valor
  • Modelo: "Olá {{1}}, seu pedido {{2}} no valor de R${{3}} está confirmado"

SMS Multi-Rota

  • Rota 0: Mensagens promocionais
  • Rota 1: Mensagens transacionais (OTPs, alertas)

Suporte a Unicode

Envie mensagens em idiomas regionais habilitando o modo Unicode.

Lista de Verificação para Começar

  • Conecte o servidor Telinfy MCP ao seu assistente de IA
  • Autentique com suas credenciais Telinfy
  • Verifique se você tem nomes de remetente e modelos DLT ativos
  • Verifique o saldo e os créditos da sua conta
  • Teste com um único SMS antes de campanhas em massa
  • Crie grupos de lista telefônica organizados
  • Configure campanhas agendadas para o momento ideal
  • Monitore os relatórios regularmente

Para especificações detalhadas da API e referências de parâmetros, consulte a documentação da API Telinfy ou entre em contato com seu gerente de conta.