Atividades de escuta

O SDK do Teams expõe um roteador fluente para que você possa assinar essas atividades com métodos de manipulador dedicados usando APIs mínimas.

O SDK do Teams expõe um roteador fluente para que você possa assinar essas atividades com @app.event("activity")o .

O SDK do Teams expõe um roteador fluente para que você possa assinar essas atividades com app.on('<route>', …)o .

teams.OnMessage(async (context, cancellationToken) =>
{
    await context.SendAsync($"you said: {context.Activity.Text}", cancellationToken);
});

@app.on_message
async def handle_message(ctx: ActivityContext[MessageActivity]):
    await ctx.send(f"You said '{ctx.activity.text}'")

app.on('message', async ({ activity, send }) => {
  await send(`You said: ${activity.text}`);
});

No exemplo acima, a context.Activity propriedade é do tipo MessageActivity, que tem uma Text propriedade. Você notará que o manipulador aqui não retorna nada, mas, em vez disso, manipula a atividade enviando Senduma mensagem de volta. Para atividades de mensagem, o Teams não espera que seu aplicativo retorne nada (embora geralmente seja uma boa ideia enviar algum tipo de reconhecimento amigável!).

No exemplo acima, o ctx.activity parâmetro é do tipo MessageActivity, que tem uma text propriedade. Você notará que o manipulador aqui não retorna nada, mas, em vez disso, manipula isso sending uma mensagem de volta. Para atividades de mensagem, o Teams não espera que seu aplicativo retorne nada (embora geralmente seja uma boa ideia enviar algum tipo de reconhecimento amigável!).

No exemplo acima, o activity parâmetro é do tipo MessageActivity, que tem uma text propriedade. Você notará que o manipulador aqui não retorna nada, mas, em vez disso, manipula isso sending uma mensagem de volta. Para atividades de mensagem, o Teams não espera que seu aplicativo retorne nada (embora geralmente seja uma boa ideia enviar algum tipo de reconhecimento amigável!).

Outros tipos de atividade têm propriedades diferentes e resultados necessários diferentes. Para um determinado manipulador, o SDK determinará automaticamente o tipo de retorno correto e também imporá o tipo de activity retorno correto.

Os comandos de barra chegam como mensagens direcionadas. Verifique Recipient.IsTargeted e manipule-os explicitamente:

teams.OnMessage(async (context, cancellationToken) =>
{
    if (context.Activity.Recipient?.IsTargeted == true)
    {
        await context.SendAsync($"Received slash command: {context.Activity.Text}", cancellationToken);
    }
});

@app.on_message
async def handle_message(ctx: ActivityContext[MessageActivity]):
    if ctx.activity.recipient and ctx.activity.recipient.is_targeted:
        await ctx.send(f"Received slash command: {ctx.activity.text}")
        return

    await ctx.next()

app.on('message', async ({ activity, send, next }) => {
  if (activity.recipient?.isTargeted) {
    await send(`Received slash command: ${activity.text}`);
    return;
  }

  await next();
});

No SDK do Teams para .NET, os manipuladores de atividade não formam uma cadeia de processamento no estilo next(). Em vez disso, cada manipulador que corresponde a uma atividade é invocado na ordem em que foi registrada e um manipulador não pode impedir que manipuladores correspondentes subsequentes sejam executados. Se você precisar interceptar, causar curto-circuito ou encapsular o processamento de solicitações (por exemplo, para interromper a execução quando uma condição for atendida), implemente ITurnMiddleware e controle se deve chamar nextTurn(...).

Os event manipuladores de atividade (e atributos) seguem um padrão de middleware semelhante ao funcionamento python dos middlewares. Isso significa que, para cada manipulador de atividade, uma next função é passada na qual pode ser chamada para passar o controle para o próximo manipulador. Isso permite que você crie uma cadeia de manipuladores que podem processar a mesma atividade de maneiras diferentes.

@app.on_message
async def handle_message(ctx: ActivityContext[MessageActivity]):
    """Handle message activities using the new generated handler system."""
    print(f"[GENERATED onMessage] Message received: {ctx.activity.text}")
    await ctx.next()

@app.on_message
async def handle_message(ctx: ActivityContext[MessageActivity]):
    """Handle message activities using the new generated handler system."""
    if ctx.activity.text == "/help":
        await ctx.send("Here are all the ways I can help you...")
    await ctx.next()

@app.on_message
async def handle_message(ctx: ActivityContext[MessageActivity]):
    await ctx.send(f"You said '{ctx.activity.text}'")

Os on manipuladores de atividades seguem um padrão de middleware semelhante ao funcionamento express dos middlewares. Isso significa que, para cada manipulador de atividade, uma next função é passada na qual pode ser chamada para passar o controle para o próximo manipulador. Isso permite que você crie uma cadeia de manipuladores que podem processar a mesma atividade de maneiras diferentes.

app.on('message', async ({ next }) => {
  console.log('global logger');
  next(); // pass control onward
});

app.on('message', async ({ activity, next }) => {
  if (activity.text === '/help') {
    await send('Here are all the ways I can help you...');
    return;
  }

  // Conditionally pass control to the next handler
  next();
});

app.on('message', async ({ activity }) => {
  // Fallthrough to the final handler
  await send(`Hello! you said ${activity.text}`);
});

Referência de atividade

O aplicativo dá suporte a vários tipos de atividade:

Principais rotas de atividade

Rotas de configuração

Rotas de Caixa de Diálogo

Rotas de autenticação

Rotas de interação de mensagens

Rotas de manipulação de arquivos

Rotas de extensão de mensagem

Rotas do ciclo de vida

Rotas de atualização de conversa

Rotas de reunião