Teams

Crew peut fonctionner comme un bot Microsoft Teams. Envoyez un MP à votre agent depuis Teams avec des réponses en diffusion continue et un indicateur de frappe.

Le Microsoft Bot Framework envoie des activités vers un point de terminaison que vous hébergez. Crew :

1. Enregistre une route entrante : POST /api/messaging/teams
2. Valide l'en-tête Authorization: Bearer <jwt> de chaque requête par rapport aux clés de signature du Bot Framework avant le traitement
3. Accuse réception rapidement avec 200, exécute le tour de l'agent en arrière-plan, puis envoie la réponse via l'API REST Bot Connector

• Une URL HTTPS publique atteignant votre passerelle (proxy inverse, tunnel de développement ou VM publique)
• L'extra Teams installé : pip install "kirocrew[teams]"
• Un enregistrement Azure Bot avec un Microsoft App ID et un secret

1. Enregistrez un Azure Bot dans le portail Azure — créez une ressource Azure Bot, notez l'App ID, créez un secret client, ajoutez le canal Microsoft Teams et définissez le point de terminaison de messagerie sur https://<your-host>/api/messaging/teams
2. Ouvrez Settings → Channels → Teams dans le tableau de bord
3. Collez l'App ID, l'App Password (secret client) et le Tenant ID (ou laissez vide pour le multilocataire)
4. Ajoutez votre courriel Azure AD ou votre ID d'objet à la liste Allowed emails
5. Cliquez sur Save — le badge d'état devient vert lorsque les identifiants sont validés

Ensuite, chargez latéralement un paquet d'application Teams (Developer Portal → nouvelle application → Bot avec votre App ID, portée Personal) et envoyez un MP au bot.

Dans ~/.kiro/crew/.env :

MICROSOFT_APP_ID=<your app id>
MICROSOFT_APP_PASSWORD=<your client secret>
MICROSOFT_APP_TENANT_ID=<tenant id or leave unset>

Dans ~/.kiro/crew/config.json :

{
  "teams": {
    "enabled": true,
    "allowed_emails": ["you@yourcompany.com"]
  }
}

Installez l'extra Teams : pip install "kirocrew[teams]"

Puis : kirocrew restart

• Le webhook est exempté de la barrière de témoins du tableau de bord — effectue sa propre validation JWT Bot Framework
• L'autorisation refuse par défaut à la fois sur la liste d'autorisation de courriels et sur la portée de conversation (personnelle seulement)
• Tous les refus sont enregistrés dans le journal des événements de sécurité
• L'App Password est marqué comme sensible et n'est jamais journalisé

• Clavardage personnel 1:1 seulement — aucun canal d'équipe, clavardage de groupe ou gestion des mentions @
• Aucune Adaptive Card / bouton pressable (les options sont livrées en texte brut)
• Aucune diffusion continue jeton par jeton — l'indicateur de frappe est affiché, la réponse finale est livrée en un seul message (fragmenté si long)