> For the complete documentation index, see [llms.txt](https://doc-builder.oftone.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc-builder.oftone.fr/reference/blocs/search-channel.md).

# Rechercher un salon

**Catégorie** — Recherche Discord · **Éditeur d’outils**

Cherche un salon ou un fil actif visible sur le serveur courant.

![Rechercher un salon dans le builder](https://60737511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvr5qJH1qHoP102m8JQrh%2Fuploads%2Fgit-blob-2d8aac92221ba276fe715b23543b68db63dbc4a9%2Fsearch-channel.png?alt=media)

## Paramètres

| Réglage                        | Valeurs acceptées                                                                                                                           |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
| Recherche                      | Texte · 256 caractères maximum · obligatoire                                                                                                |
| Mode de recherche              | Choix · Automatique, Correspondance exacte, Contient le texte, Commence par le texte, Correspondance approximative · par défaut Automatique |
| Nombre maximal de résultats    | Nombre · de 1 à 100 · par défaut `20`                                                                                                       |
| Trier par pertinence           | Interrupteur · par défaut activé                                                                                                            |
| Nom de la recherche (variable) | Texte · 32 caractères maximum · obligatoire · par défaut `salons`                                                                           |

## Entrées, sorties et variables

Une entrée et une sortie. La recherche peut utiliser une variable de texte. Avec le nom de sortie par défaut, le bloc fournit `{discord_salons_result}`, `{discord_salons_count}`, `{discord_salons_status}`, `{discord_salons_error}`, `{discord_salons_first_id}`.

## Exécution et limites

Exécutez ce bloc dans un outil. Les résultats dépendent du serveur courant et de ce que le bot peut consulter. La sortie fournit au plus le nombre demandé.

## Exemple

Cherchez `annonces` en mode exact, puis renvoyez `{discord_salons_first_id}` si un seul résultat correspond.

## Erreurs courantes

Avec zéro résultat, vérifiez le nom et le serveur. Avec plusieurs correspondances, demandez une précision ou comparez le nombre avant de choisir l’ID. Traitez aussi le statut partiel.

## Blocs associés

[Rechercher un rôle](/reference/blocs/search-role.md) · [Renvoyer un résultat](/reference/blocs/return-tool-result.md)
