Torna alla Dashboard

Documentazione

Scopri come usare Asyntai

Integrazione Discord

Connect Asyntai AI to your Discord server for automated responses and moderation

Connetti Discord

Panoramica

Asyntai's Discord integration adds an AI-powered bot to your Discord server. Community members can ask questions and get instant answers from your knowledge base. The bot supports three response modes and optional AI moderation.

Requisito del piano: Discord integration is available on Starter, Standard, and Pro plans.

Come installare

Follow these steps to add the Asyntai bot to your Discord server:

1

Add the Bot to Your Server

Vai alla pagina di configurazione Discord e clicca "Aggiungi a Discord". Seleziona il tuo server e clicca Autorizza. Il bot è pronto istantaneamente — nessuna configurazione aggiuntiva. Puoi aggiungere il bot a più server — clicca di nuovo "Aggiungi a Discord" per ognuno. Ogni server ha le proprie impostazioni.

2

Choose a Response Mode

After connecting, select how the bot interacts with your community:

- @mention (default) — The bot responds when someone tags it. Best for servers where you want the bot available but not intrusive.

- Tutti i messaggi — L'IA legge ogni messaggio e decide se rispondere. Ideale per canali di supporto dedicati. Include opzioni aggiuntive:

- Modalità intelligente (attiva per impostazione predefinita) — L'IA usa il suo giudizio per saltare la chat informale e risponde solo quando può aiutare. Disattivata, il bot risponde a ogni messaggio.

- Consapevolezza del canale — L'IA vede l'intera conversazione del canale da tutti gli utenti, non solo thread individuali. Questo le permette di seguire discussioni di gruppo e rispondere nel contesto.

- /ask command — Users type /ask followed by their question. Best for large servers where you want explicit bot interaction.

You can change the mode at any time from the setup page.

3

Test It Out

Go to any channel in your Discord server and tag the bot or use the /ask command. You should receive an AI-powered response within seconds.

Moderazione IA

The Discord bot can also moderate your server. When enabled, the AI reads every message and takes action based on rules you define. Each action can be independently enabled:

Nota: Ogni controllo di moderazione conta come 1 messaggio della quota mensile del tuo piano, anche se l'IA non intraprende alcuna azione.

- Delete messages — Remove messages that violate your rules (spam, NSFW, etc.)

- Warn users — Send a visible warning for minor violations

- Kick users — Remove users from the server for repeated violations

- Ban users — Permanently ban users for severe violations

Moderation runs independently of the response mode. Even in /ask-only mode, moderation still monitors every message.

Tutte le azioni di moderazione vengono registrate e sono visibili nella pagina Registro moderazione, accessibile dalla pagina di configurazione. Puoi vedere quale azione è stata intrapresa, il motivo, il messaggio originale e quando è accaduto.

Suggerimento: Start with Delete only, and add stronger actions once you are confident in the rules. The AI errs on the side of caution — when in doubt, it takes no action.

Messaggi proattivi

Il bot può avviare conversazioni autonomamente pubblicando messaggi AI secondo un programma. Attivalo nella pagina di configurazione:

- Nome del canale — In quale canale il bot pubblica (es. general, support)

- Frequenza — Quanto spesso: ogni 2, 4, 6, 12 ore, giornalmente, ogni 2 giorni o settimanalmente

- Argomenti — Di cosa deve parlare il bot. L'IA genera un messaggio fresco e unico ogni volta basandosi sui tuoi argomenti.

Each proactive message counts as 1 message toward your plan quota.

Suggerimento: Usa i messaggi proattivi per condividere consigli, evidenziare funzionalità o mantenere la tua community attiva — anche quando nessuno fa domande.

Come funziona

Once connected, here is what happens:

1. A community member sends a message in your Discord server

2. If moderation is enabled, the AI evaluates the message against your rules

3. If a response is triggered (by @mention, /ask, or all-messages mode), the AI generates an answer using your knowledge base

4. The response is sent in the channel, and the conversation is logged in your Asyntai dashboard

The AI maintains conversation context per user, so follow-up questions are understood in relation to previous messages.

Monitoraggio in tempo reale & Intervento umano

Discord conversations appear in your Asyntai dashboard alongside other channels. On Standard and Pro plans, you can:

- Live Monitoring — See active Discord conversations in real time from the monitoring dashboard

- Human Takeover — Take over from the AI when a human touch is needed. The AI pauses and resumes automatically after 3 minutes of agent inactivity.

- Escalation — The AI can detect when a user wants to speak to a human and notify you by email

Advanced: Custom Bot Setup

If you prefer to use your own Discord Application instead of the shared Asyntai bot, expand the manual setup section on the setup page and provide your Application ID, Public Key, and Bot Token.

You will also need to set the Interactions Endpoint URL to https://asyntai.com/discord/webhook/ in the Discord Developer Portal.

Prezzi

Discord integration is included in paid Asyntai plans:

- Starter ($39/mese) - 2.500 messaggi/mese

- Standard ($139/mese) - 15.000 messaggi/mese

- Pro ($449/mese) - 50.000 messaggi/mese

Messages from Discord count toward your monthly message quota, shared across all channels (widget, Instagram, WhatsApp, etc.).

Risoluzione dei problemi

Bot not responding

Check that the bot is online in your server member list. If using @mention or all-messages mode, the Gateway bot process must be running. If using /ask only, make sure the Interactions Endpoint URL is set in the Discord Developer Portal.

Moderation not working

Ensure moderation is enabled on the setup page with at least one action toggled on and rules filled in. The bot also needs Manage Messages, Kick Members, or Ban Members permissions depending on the action.

Missing permissions

If the bot cannot delete messages or kick/ban users, check that its role in Discord has the necessary permissions and is positioned above the roles of the users it needs to moderate.

Bot shows offline

The @mention and all-messages modes require the Gateway bot process to be running. Start it with python manage.py discord_bot and ensure it stays running as a background service. The /ask slash command works without the Gateway process.

Hai bisogno di aiuto?

Se hai domande o riscontri problemi, contattaci all'indirizzo hello@asyntai.com.