Buscar mensagens no Discord, por uma API

Busca as mensagens de um servidor, até 25 por página, da mais nova para a mais antiga por padrão; pagine com offset. A resposta tem total_results e messages, uma lista de listas de uma mensagem. Se o servidor ainda não foi indexado, o Discord responde 202 com retry_after: chame de novo após esses segundos. Exige Message Content Intent no bot.

Identificador
discord_search_messages

A chamada

POST https://connect.reportei.com/api/tools/discord_search_messages/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json

{
  "customer_toolkit": "<connection UUID>",
  "arguments": {
    "guild_id": "<guild_id>"
  }
}

Seu sistema envia o id da conexão do cliente e os argumentos da tool. Os headers são os mesmos de toda a API do Connect: o token do seu produto e o token do cliente.

Parâmetros

As descrições dos parâmetros seguem a documentação oficial do app, em inglês.

ParâmetroTipoObrigatórioDescrição
guild_idstringSimId of the server, from List guilds.
contentstringNãoWords to find in the text of the messages.
channel_idarrayNãoOnly messages in these channels, ids from List channels.
author_idarrayNãoOnly messages from these people, the author.id of messages from List messages.
author_typearrayNãoOnly messages from people (user), bots or webhooks. A leading minus excludes the type.
mentionsarrayNãoOnly messages that mention these people, by the author.id of messages from List messages.
hasarrayNãoOnly messages that have these things, such as image, link or poll. A leading minus excludes the thing.
pinnedbooleanNãotrue for pinned messages only, false for the others.
min_idstringNãoOnly messages after this message id, from List messages.
max_idstringNãoOnly messages before this message id, from List messages.
sort_bystringNãotimestamp, the default, or relevance to content.Valores: timestamp, relevance
sort_orderstringNãodesc, the default, or asc. Ignored when sort_by is relevance.Valores: desc, asc
limitintegerNãoMessages per page, up to 25, the default.
offsetintegerNãoNumber of results to skip, up to 9975.
include_nsfwbooleanNãotrue also searches age-restricted channels.

Conexões possíveis

O seu cliente conecta a conta do Discord uma vez, por um dos modos abaixo. A mesma conexão serve para todas as tools do toolkit.

Chave de API

O cliente cola a chave do app numa tela do Connect, ou o seu sistema envia a chave por POST /api/customer-toolkits, sem tela.

A resposta

Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app. Erros HTTP retornados pelo app usam o envelope {error, api_error}; falhas de autenticação ou validação podem ocorrer antes da execução. O header X-Toolkit-Execution-Id identifica a execução registrada, consultável em GET /api/tools/executions/{uuid}.

Pronta para agentes de IA

O input desta tool é um JSON Schema, disponível em GET /api/tools/discord_search_messages. Ele vira a definição de tool do seu agente sem conversão.

Outras tools do Discord

Ver as 12 tools

Toolkits da mesma categoria

Ver os 100 toolkits

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.