> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Modulo Users

> Invita utenti all'app tramite base44.users.

<Warning>
  Questa pagina fa parte di una skill per agenti IA di programmazione ed è scritta per gli agenti, non per gli umani. Per la documentazione Base44 leggibile dagli umani, consulta la [documentazione per sviluppatori](/developers).
</Warning>

# Modulo Users

Invita utenti all'app tramite `base44.users`.

## Contenuti

* [Metodi](#methods)
* [Esempi](#examples) (Invita utente)
* [Ruoli](#roles)
* [Note](#notes)

## Metodi

| Metodo                         | Firma          | Descrizione              |
| ------------------------------ | -------------- | ------------------------ |
| `inviteUser(user_email, role)` | `Promise<any>` | Invita un utente all'app |

## Esempi

### Invitare un utente

```javascript theme={null}
// Invite a user with "user" role
await base44.users.inviteUser("newuser@example.com", "user");

// Invite an admin
await base44.users.inviteUser("admin@example.com", "admin");
```

### Invitare più utenti

```javascript theme={null}
const usersToInvite = [
  { email: "user1@example.com", role: "user" },
  { email: "user2@example.com", role: "user" },
  { email: "manager@example.com", role: "admin" }
];

for (const user of usersToInvite) {
  await base44.users.inviteUser(user.email, user.role);
  console.log(`Invited ${user.email} as ${user.role}`);
}
```

## Ruoli

Il parametro `role` deve essere uno tra:

| Ruolo     | Descrizione                             |
| --------- | --------------------------------------- |
| `"user"`  | Utente standard con permessi di default |
| `"admin"` | Amministratore con permessi elevati     |

**Nota:** solo `"user"` e `"admin"` sono valori di ruolo validi. Se passi un altro valore viene generato un errore.

## Note

* **Invito via email**: l'utente invitato riceve un'email con un link per unirsi all'app
* **Gestione dei duplicati**: invitare un utente esistente rinvia l'invito
* **Disponibile anche in auth**: `base44.auth.inviteUser()` offre la stessa funzionalità
* **Validazione del ruolo**: sono accettati solo `"user"` o `"admin"`

```javascript theme={null}
// These are equivalent:
await base44.users.inviteUser("newuser@example.com", "user");
await base44.auth.inviteUser("newuser@example.com", "user");
```

## Definizioni dei tipi

```typescript theme={null}
/** Users module for inviting users to the app. */
interface UsersModule {
  /**
   * Invite a user to the application.
   * @param user_email - User's email address.
   * @param role - User's role ('user' or 'admin').
   * @returns Promise resolving when the invitation is sent.
   * @throws Error if role is not 'user' or 'admin'.
   */
  inviteUser(user_email: string, role: "user" | "admin"): Promise<any>;
}
```

<Note>Questa pagina è stata tradotta utilizzando l'IA. Per informazioni più accurate e aggiornate, consulta la [versione inglese](/). </Note>
