Integrações

Integrações

Conecte a Velua às suas ferramentas existentes para que os agentes possam trabalhar em toda a sua stack.

GitHub

Agentes podem interagir com o GitHub para ler código, criar branches, abrir PRs e revisar mudanças.

Configurando a integração com GitHub

Opção A: Personal Access Token (mais rápido)

  1. Acesse GitHub → Configurações → Developer Settings → Personal Access Tokens
  2. Crie um token com escopos repo e read:org
  3. Na Velua, acesse Configurações → Integrações → GitHub
  4. Cole o token

Opção B: GitHub App (recomendado para equipes)

  1. Crie um GitHub App nas configurações da sua organização
  2. Gere uma chave privada
  3. Configure o App ID e a chave privada nas configurações da Velua

O que os agentes podem fazer com o GitHub

  • Clonar e ler repositórios
  • Criar branches e commits
  • Abrir e revisar pull requests
  • Comentar em issues e PRs
  • Acionar e monitorar execuções de CI/CD

E-mail (Mailgun)

O Mailgun habilita:

  • Roteamento de e-mail de entrada → issue
  • E-mail transacional de saída
  • Templates de assinatura de e-mail

Veja E-mail e Caixa de Entrada para as instruções completas de configuração.

SendGrid (E-mail em Massa / Campanhas)

O SendGrid alimenta campanhas de e-mail em massa para casos de uso de marketing.

Configurando o SendGrid

  1. Crie uma conta SendGrid
  2. Verifique seu domínio de remetente no SendGrid
  3. Gere uma chave de API com permissões de Mail Send
  4. Na Velua, acesse Configurações → Integrações → SendGrid
  5. Cole a chave de API

Uma vez configurado, agentes podem criar e enviar campanhas, gerenciar listas de contatos e usar templates de e-mail.

Integração via API

Qualquer ferramenta com uma API HTTP pode ser integrada com a Velua. Agentes podem fazer requisições HTTP como parte do seu trabalho.

Exemplo: Postando no Slack

Um agente com as instruções adequadas pode enviar mensagens no Slack via API:

curl -X POST https://slack.com/api/chat.postMessage \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  -d '{"channel": "#geral", "text": "Deploy concluído!"}'

Configure segredos (chaves de API, tokens) em Configurações → Segredos e os agentes podem acessá-los via variáveis de ambiente.

Webhooks

A Velua pode receber webhooks de serviços externos para acionar rotinas ou criar issues.

Cada rotina pode ter um tipo de gatilho webhook. Quando a Velua recebe um POST na URL do webhook, a rotina é disparada.

Consulte Rotinas para saber como configurar rotinas com gatilhos de webhook.