Automação do WhatsApp Business via Rube MCP

Automatize operações do WhatsApp Business através do kit de ferramentas do WhatsApp da Composio via Rube MCP.

Pré-requisitos

• Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa do WhatsApp via RUBE_MANAGE_CONNECTIONS com o kit de ferramentas whatsapp
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais
• Conta da API do WhatsApp Business necessária (não WhatsApp comum)

Configuração

Obtenha o Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o kit de ferramentas whatsapp
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para concluir a configuração do WhatsApp Business
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Enviar uma Mensagem de Texto

Quando usar: O usuário deseja enviar uma mensagem de texto para um contato do WhatsApp

Sequência de ferramentas:

1. WHATSAPP_GET_PHONE_NUMBERS - Listar números de telefone comerciais disponíveis [Pré-requisito]
2. WHATSAPP_SEND_MESSAGE - Enviar uma mensagem de texto [Obrigatório]

Parâmetros chave:

• to: Número de telefone do destinatário em formato internacional (ex: '+14155551234')
• body: Conteúdo do texto da mensagem
• phone_number_id: ID do número de telefone comercial para enviar

Armadilhas:

• Números de telefone devem estar no formato internacional E.164 com código do país
• Mensagens fora da janela de 24 horas exigem modelos aprovados
• A janela de 24 horas começa quando o cliente enviou a última mensagem para você
• Conversas iniciadas pelo negócio exigem modelos de mensagem primeiro

2. Enviar Mensagens de Modelo

Quando usar: O usuário deseja enviar mensagens de modelo pré-aprovadas para comunicação de saída

Sequência de ferramentas:

1. WHATSAPP_GET_MESSAGE_TEMPLATES - Listar modelos disponíveis [Pré-requisito]
2. WHATSAPP_GET_TEMPLATE_STATUS - Verificar status de aprovação do modelo [Opcional]
3. WHATSAPP_SEND_TEMPLATE_MESSAGE - Enviar a mensagem de modelo [Obrigatório]

Parâmetros chave:

• template_name: Nome do modelo aprovado
• language_code: Idioma do modelo (ex: 'pt_BR')
• to: Número de telefone do destinatário
• components: Valores de variáveis do modelo e parâmetros

Armadilhas:

• Modelos devem ser aprovados pela Meta antes do uso
• Variáveis de modelo devem corresponder à contagem e formato esperados
• Enviar modelos não aprovados ou rejeitados retorna erros
• O código do idioma deve corresponder a uma tradução aprovada do modelo

3. Enviar Mensagens de Mídia

Quando usar: O usuário deseja enviar imagens, documentos ou outras mídias

Sequência de ferramentas:

1. WHATSAPP_UPLOAD_MEDIA - Carregar mídia para os servidores do WhatsApp [Obrigatório]
2. WHATSAPP_SEND_MEDIA_BY_ID - Enviar mídia usando o ID da mídia carregada [Obrigatório] OU
3. WHATSAPP_SEND_MEDIA - Enviar mídia usando um URL público [Alternativa]

Parâmetros chave:

• media_url: URL público da mídia (para SEND_MEDIA)
• media_id: ID da resposta do upload (para SEND_MEDIA_BY_ID)
• type: Tipo de mídia ('image', 'document', 'audio', 'video', 'sticker')
• caption: Legenda opcional para a mídia

Armadilhas:

• IDs de mídia carregada são temporários e expiram após um período
• Limites de tamanho de mídia variam por tipo (imagens: 5MB, vídeos: 16MB, documentos: 100MB)
• Formatos suportados: imagens (JPEG, PNG), vídeos (MP4, 3GPP), documentos (PDF, etc.)
• SEND_MEDIA requer um URL HTTPS publicamente acessível

4. Responder a Mensagens

Quando usar: O usuário deseja responder a uma mensagem de WhatsApp recebida

Sequência de ferramentas:

1. WHATSAPP_SEND_REPLY - Enviar uma resposta a uma mensagem específica [Obrigatório]

Parâmetros chave:

• message_id: ID da mensagem que está sendo respondida
• to: Número de telefone do destinatário
• body: Conteúdo do texto da resposta

Armadilhas:

• message_id deve ser de uma mensagem recebida dentro da janela de 24 horas
• Respostas aparecem como mensagens citadas na conversa
• A mensagem original deve ainda existir (não deletada) para que a citação seja exibida

5. Gerenciar Perfil e Modelos Comerciais

Quando usar: O usuário deseja visualizar ou gerenciar seu perfil comercial do WhatsApp

Sequência de ferramentas:

1. WHATSAPP_GET_BUSINESS_PROFILE - Obter detalhes do perfil comercial [Opcional]
2. WHATSAPP_GET_PHONE_NUMBERS - Listar números de telefone registrados [Opcional]
3. WHATSAPP_GET_PHONE_NUMBER - Obter detalhes para um número específico [Opcional]
4. WHATSAPP_CREATE_MESSAGE_TEMPLATE - Criar um novo modelo [Opcional]
5. WHATSAPP_GET_MESSAGE_TEMPLATES - Listar todos os modelos [Opcional]

Parâmetros chave:

…