Criar thread no Discord, por uma API

Cria uma thread em um canal de texto ou de anúncios, ou um post em um canal de fórum ou mídia, e a retorna com seu id, que as tools de mensagem usam como channel_id. Em fórum ou mídia envie message, o primeiro post; nos demais envie type, porque o padrão é uma thread privada. O bot precisa de Create Public Threads, ou Send Messages em um fórum.

Identificador
discord_create_thread

A chamada

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

{
  "customer_toolkit": "<connection UUID>",
  "arguments": {
    "channel_id": "<channel_id>",
    "name": "<name>"
  }
}

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
channel_idstringSimId of the channel, from List channels.
namestringSimName of the thread or title of the post, up to 100 characters.
typeintegerNãoOutside forums: 11 public thread, 12 private thread, the default, or 10 in an announcement channel. Not used in a forum or media channel.Valores: 10, 11, 12
auto_archive_durationintegerNãoMinutes without activity before the thread is hidden from the channel list.Valores: 60, 1440, 4320, 10080
invitablebooleanNãoFor a private thread, true lets members who are not moderators add others.
messageobjectNãoFirst post of a forum or media channel thread. Send content or embeds.
applied_tagsarrayNãoUp to 5 tags of a forum or media channel post: ids from the available_tags of the channel in List 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_create_thread. 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.