Se você fizer parte de uma conta Enterprise com múltiplas organizações ou funções personalizadas, consulte o Início rápido do Enterprise.
Etapa 1: Criar um usuário de serviço
- Acesse Settings > Devin API na sua organização e abra a aba Usuários de serviço
- Clique em Provisionar usuário de serviço
- Escolha um nome de exibição descritivo (por exemplo, “CI Pipeline”, “Monitoring Bot”)
- Selecione uma função no menu suspenso Organization role. O formulário não tem caixas de seleção para permissões individuais: o usuário de serviço recebe as permissões da função escolhida.
- Admin — acesso total, incluindo configurações da organização e associação
- Member — pode criar e gerenciar sessões do Devin e a maioria dos recursos da organização, mas não as configurações da organização nem a associação
- Escolha uma Expiração. O padrão é 30 days; as outras opções são 7 dias, 90 dias e, se sua conta permitir, Never. Após a data de expiração, a chave de API do usuário de serviço deixa de funcionar; por isso, provisione um substituto antes disso. Uma expiração mais curta reduz o tempo durante o qual uma chave vazada pode ser usada.
Etapa 2: Copie sua chave de API
- Após provisionar o usuário de serviço, a chave de API dele é exibida em uma caixa de diálogo
- Copie a chave imediatamente — ela começa com
cog_e não será exibida novamente - Armazene-a com segurança como uma variável de ambiente:
Etapa 3: Faça sua primeira chamada à API
Crie uma sessão do Devin:Quer que as sessões sejam atribuídas ao seu usuário? Por padrão, as sessões são atribuídas ao usuário de serviço. Para criar sessões em nome de um usuário específico (para que apareçam na lista de sessões desse usuário), adicione
"create_as_user_id": "user_abc123" ao corpo da requisição. Isso requer a função Admin (que inclui a permissão ImpersonateOrgSessions). Consulte Atribuição de sessões para mais detalhes.Passo 4: Operações comuns
Liste suas sessões
Enviar uma mensagem para uma sessão ativa
Gerenciar o Knowledge
Permissões para usuários do Teams
Organizações do Teams têm um modelo de permissões simples:Os playbooks estão sendo migrados para Habilidades. Em uma conta do Teams que já foi migrada, as gravações em
/playbooks vão para a skill correspondente ao playbook. Uma conta criada a partir de 24 de outubro de 2026 que não tenha playbooks recebe 410 dos endpoints /playbooks.Próximas etapas
- Explore os endpoints da Organization API na barra lateral
- Consulte fluxos comuns para padrões de integração comuns
- Saiba mais sobre autenticação em detalhes
- Configure automações agendadas para tarefas recorrentes

