Telinfy MCP server

Guia de Integração Telinfy MCP

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

O servidor Telinfy MCP fornece acesso programático aos recursos 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 com segurança 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 aplicativos 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 SMS para entrega futura
3. scheduleDynamicCampaign - Agendar campanhas SMS dinâmicas usando arquivos Excel e variáveis de modelo
4. get_sms_schedule - Visualizar todas as campanhas SMS agendadas
5. fetch_sms_campaign_report - Obter relatórios detalhados para campanhas SMS

Operações WhatsApp

6. send_whatsapp_campaign - Enviar mensagens WhatsApp usando modelos pré-criados
7. whatsapp_campaign - Listar todas as campanhas WhatsApp
8. fetch_whatsapp_smart_report - Obter relatórios de campanhas WhatsApp com filtro por data

Operações RCS

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

Gerenciamento de Contatos

10. create_phonebook - Criar novos grupos de agenda com contatos
11. get_phonebook_groups - Listar todos os grupos de agenda
12. get_group_contacts - Visualizar contatos dentro de um grupo específico
13. edit_contact - Atualizar informações de contato
14. toggle_contact_status - Ativar/desativar contatos em um grupo
15. delete_contact_group - Remover grupos de agenda

Relatórios de Mensagens

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

Autenticação

17. 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 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 WhatsApp

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

Obter Relatórios de Campanha

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 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 SMS personalizadas usando arquivos Excel com substituição de variáveis, perfeito para mensagens personalizadas em massa.

Mensagens Multicanal

• SMS - Rotas promocionais e transacionais
• WhatsApp - Mensagens comerciais baseadas em modelos
• RCS - Rich Communication Services

Relatórios Abrangentes

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

Gerenciamento de Contatos

Organize contatos em grupos, ative/desative contatos e mantenha listas de agenda 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 duração da sua conversa
• Nenhuma credencial é armazenada pelo assistente de IA

---

Suporte e Recursos

• Painel Telinfy: https://telinfy.com
• Documentação da API: Entre em contato com o suporte Telinfy para obter documentação detalhada da API
• Protocolo MCP: https://modelcontextprotocol.io
• Suporte: Entre em contato com seu gerente de conta Telinfy

---

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 é 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 estão sendo enviadas:

1. Garanta que você tenha 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-se no início de cada sessão
2. Use IDs de modelo corretos - Garanta que os modelos DLT correspondam ao conteúdo da sua mensagem
3. Verifique formatos de telefone - Use números indianos de 10 dígitos ou formato internacional com código do país
4. Verifique relatórios de campanha - Monitore o status de entrega regularmente
5. Gerencie contatos com eficiência - Mantenha grupos de agenda organizados
6. Teste antes do envio em massa - Envie mensagens de teste antes de campanhas grandes

---

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"
   

2. Criar Grupo de Contatos

   Create a phonebook group "Spring Sale 2024" with my customer list
   

3. 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"
   

4. 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:

• Envie um Excel com colunas: Mobile, Name, OrderID, Amount
• Mapeie variáveis: {{1}} = Name, {{2}} = OrderID, {{3}} = Amount
• Modelo: "Hi {{1}}, your order {{2}} of Rs.{{3}} is confirmed"

SMS Multi-Rota

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

Suporte a Unicode

Envie mensagens em idiomas regionais ativando o modo Unicode.

---

Lista de Verificação para Começar

• Conecte o servidor Telinfy MCP ao seu assistente de IA
• Autentique-se com suas credenciais Telinfy
• Verifique se você tem nomes de remetente ativos e modelos DLT
• Verifique seu saldo e créditos da conta
• Teste com um único SMS antes de campanhas em massa
• Crie grupos de agenda organizados
• Configure campanhas agendadas para o melhor momento
• Monitore 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.