Automação Webex (ComposioHQ/Webex-Automation)

Automação Webex

Automatize fluxos de trabalho de colaboração do Cisco Webex – envie mensagens, gerencie salas e equipes, configure webhooks e consulte pessoas – tudo por meio de linguagem natural.

Documentação do toolkit: composio.dev/toolkits/webex

---

Configuração

1. Adicione o servidor MCP Rube ao seu ambiente: https://rube.app/mcp
2. Conecte sua conta do Webex quando solicitado (fluxo OAuth via Composio)
3. Comece a emitir comandos em linguagem natural para automação do Webex

---

Fluxos de Trabalho Principais

1. Enviar uma Mensagem para uma Sala ou Pessoa

Envie texto simples, markdown, anexos de arquivo ou Adaptive Cards para qualquer sala do Webex ou diretamente para uma pessoa.

Ferramenta: WEBEX_MESSAGING_CREATE_MESSAGE

Parâmetros principais:

• roomId – ID da sala de destino (use WEBEX_MESSAGING_LIST_ROOMS para encontrá-la)
• toPersonEmail – enviar uma mensagem privada 1:1 (mutuamente exclusivo com roomId)
• text – conteúdo em texto simples (máximo 7439 bytes)
• markdown – conteúdo formatado em markdown (tem precedência sobre text)
• files – lista de URLs públicas para anexos de arquivo (um arquivo por mensagem)
• attachments – JSON do Adaptive Card (um card por mensagem)
• parentId – responder a uma mensagem específica como uma resposta encadeada

Exemplo de prompt:

"Envie uma mensagem markdown para a sala Y2lz... dizendo Implantação concluída com um link para as notas de versão"

---

2. Listar e Descobrir Salas

Navegue por todas as salas das quais você faz parte, filtrando por tipo, equipe ou ordenando por atividade.

Ferramenta: WEBEX_MESSAGING_LIST_ROOMS

Parâmetros principais:

• type – filtrar por direct (1:1) ou group
• teamId – limitar a salas de uma equipe específica
• sortBy – ordenar por id, lastactivity ou created
• max – limitar resultados (1-1000, padrão 100)

Em seguida, use WEBEX_MESSAGING_GET_ROOM_DETAILS para obter metadados completos de uma sala específica, incluindo título, tipo, status de bloqueio, criador e timestamps.

Exemplo de prompt:

"Liste minhas 10 salas de grupo mais recentemente ativas no Webex"

---

3. Gerenciar Webhooks para Automação Orientada a Eventos

Crie webhooks para receber notificações POST HTTP em tempo real quando recursos do Webex forem alterados.

Ferramenta: WEBEX_WEBHOOKS_CREATE_WEBHOOK

Parâmetros principais:

• name – nome amigável do webhook (obrigatório)
• targetUrl – URL que recebe as notificações POST (obrigatório)
• resource – o que monitorar: messages, rooms, memberships, meetings, recordings, meetingParticipants, telephony_calls, etc. (obrigatório)
• event – tipo de gatilho: created, updated, deleted, started, ended, joined, left (obrigatório)
• filter – escopo das notificações (ex.: roomId=<id> ou hostEmail=<email>)
• secret – segredo HMAC opcional para verificação de assinatura do payload
• ownedBy – creator para webhooks pessoais ou org para webhooks organizacionais

Ferramentas de suporte:

• WEBEX_LIST_WEBHOOKS – lista todos os webhooks registrados com filtros opcionais max e ownedBy
• WEBEX_WEBHOOKS_GET_WEBHOOK – inspeciona um webhook específico por webhookId

Exemplo de prompt:

"Crie um webhook chamado 'Novas Mensagens' que faça POST para https://my-app.com/hook sempre que uma mensagem for criada na sala Y2lz..."

---

4. Gerenciar Associações de Equipe

Adicione pessoas a equipes do Webex e, opcionalmente, conceda privilégios de moderador.

Ferramenta: WEBEX_MESSAGING_CREATE_TEAM_MEMBERSHIP

Parâmetros principais:

• teamId – a equipe para adicionar a pessoa (obrigatório)
• personEmail – e-mail da pessoa a ser adicionada
• personId – ID da pessoa no Webex (alternativa ao e-mail)
• isModerator – defina como true para acesso de moderador (padrão false)

Use WEBEX_LIST_TEAMS para descobrir as equipes disponíveis primeiro.

Exemplo de prompt:

"Adicione [email protected] como moderadora à equipe Y2lz..."

---

5. Auditar Associações de Sala

Verifique quem está em uma sala, confirme a associação de uma pessoa específica ou liste associações em equipes.

Ferramenta: WEBEX_MESSAGING_LIST_MEMBERSHIPS

Parâmetros principais:

• roomId – lista todos os membros de uma sala específica
• personEmail – verifica se uma pessoa é membro (requer roomId)
• personId – verifica pelo ID da pessoa no Webex (requer roomId)
• teamId – filtrar por associação à equipe
• max – limitar resultados

Exemplo de prompt:

"Liste todos os membros da sala Y2lz... e me diga quem são os moderadores"

---

6. Pesquisar e Consultar Pessoas

Consulte pessoas na sua organização do Webex por e-mail, nome de exibição ou ID.

Ferramenta: WEBEX_PEOPLE_LIST_PEOPLE

Use para resolver nomes em IDs de pessoa antes de enviar mensagens diretas ou adicionar membros à equipe.

Exemplo de prompt:

"Encontre o ID da pessoa no Webex para [email protected]"

---

Problemas Conhecidos

Problema	Detalhes
Desativação automática de webhook	A URL de destino deve responder com HTTP 2xx; 100 falhas em 5 minutos desativam o webhook automaticamente
Limite de tamanho de mensagem	Tanto text quanto markdown têm um máximo de 7439 bytes
Um arquivo por mensagem	O array files aceita uma lista, mas apenas um anexo é suportado por mensagem
Um card por mensagem	Apenas um anexo Adaptive Card é suportado por mensagem
Destinos mutuamente exclusivos	roomId e toPersonEmail/toPersonId não podem ser usados juntos ao enviar mensagens
Atualização de sala requer título	WEBEX_UPDATE_ROOM sempre requer o parâmetro title, mesmo ao alterar apenas o status de bloqueio ou a equipe
Conflitos com orgPublicSpaces	Não é possível combinar orgPublicSpaces com teamId, type ou sortBy ao listar salas
Escopo de leitura de webhook	Criar um webhook requer escopo read no tipo de recurso monitorado
Filtro de associação requer roomId	Os filtros personEmail e personId em listar associações exigem roomId, a menos que você seja um Oficial de Conformidade

---

Referência Rápida

Ação	Slug da Ferramenta	Parâmetros Principais
Enviar mensagem	WEBEX_MESSAGING_CREATE_MESSAGE	roomId, text/markdown, toPersonEmail
Listar salas	WEBEX_MESSAGING_LIST_ROOMS	type, sortBy, max
Obter detalhes da sala	WEBEX_MESSAGING_GET_ROOM_DETAILS	roomId
Atualizar sala	WEBEX_UPDATE_ROOM	roomId, title
Excluir mensagem	WEBEX_MESSAGING_DELETE_MESSAGE	messageId
Obter detalhes da mensagem	WEBEX_MESSAGING_GET_MESSAGE_DETAILS	messageId
Criar webhook	WEBEX_WEBHOOKS_CREATE_WEBHOOK	name, targetUrl, resource, event
Listar webhooks	WEBEX_LIST_WEBHOOKS	max, ownedBy
Obter webhook	WEBEX_WEBHOOKS_GET_WEBHOOK	webhookId
Adicionar membro da equipe	WEBEX_MESSAGING_CREATE_TEAM_MEMBERSHIP	teamId, personEmail, isModerator
Listar associações	WEBEX_MESSAGING_LIST_MEMBERSHIPS	roomId, personEmail, max
Listar pessoas	WEBEX_PEOPLE_LIST_PEOPLE	filtros de e-mail, nome de exibição, ID
Listar equipes	WEBEX_LIST_TEAMS	max

---

Desenvolvido por Composio