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

# Registrar Usuário

## Descricao

Este endpoint permite registrar um novo usuario e obter informacoes como nome, e-mail, telefone, `authkey`, data de expiracao e o plano do usuario.

### Parametros

<ParamField body="email" type="string" required>
  O e-mail do usuario para registro.
</ParamField>

<ParamField body="senha" type="string" required>
  A senha do usuario para registro.
</ParamField>

<ParamField body="nome" type="string" required>
  Nome completo do usuario.
</ParamField>

<ParamField body="telefone" type="string" required>
  Numero de telefone do usuario (incluindo codigo do pais).
</ParamField>

<ParamField body="plano" type="string" required>
  ID do plano do usuario.
</ParamField>

<ParamField body="auth" type="string" required>
  Identificador da requisicao, deve ser "registrar" para registrar um novo usuario.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://chatbot.menuia.com/api/auth \
    -H "Content-Type: application/json" \
    -d '{
      "email": "exemplo@exemplo.com",
      "senha": "SuaSenhaAqui",
      "nome": "Joao",
      "telefone": "+558198976996",
      "plano": "ID_DO_PLANO",
      "auth": "registrar"
    }'
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://chatbot.menuia.com/api/auth', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      email: 'exemplo@exemplo.com',
      senha: 'SuaSenhaAqui',
      nome: 'Joao',
      telefone: '+558198976996',
      plano: 'ID_DO_PLANO',
      auth: 'registrar'
    })
  });
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      'https://chatbot.menuia.com/api/auth',
      json={
          'email': 'exemplo@exemplo.com',
          'senha': 'SuaSenhaAqui',
          'nome': 'Joao',
          'telefone': '+558198976996',
          'plano': 'ID_DO_PLANO',
          'auth': 'registrar'
      }
  )
  ```

  ```php PHP theme={null}
  $response = Http::post('https://chatbot.menuia.com/api/auth', [
      'email' => 'exemplo@exemplo.com',
      'senha' => 'SuaSenhaAqui',
      'nome' => 'Joao',
      'telefone' => '+558198976996',
      'plano' => 'ID_DO_PLANO',
      'auth' => 'registrar'
  ]);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - Sucesso theme={null}
  {
    "status": 200,
    "message": "Usuario registrado com sucesso.",
    "data": {
      "nome": "Joao",
      "email": "exemplo@exemplo.com",
      "telefone": "+558198976996",
      "authkey": "SUA_AUTHKEY_AQUI",
      "expiracao": "2025-12-31",
      "plano": "premium"
    }
  }
  ```

  ```json 401 - Erro de validacao theme={null}
  {
    "status": 401,
    "message": "validation.required"
  }
  ```

  ```json 409 - Usuario ja existe theme={null}
  {
    "status": 409,
    "message": "Usuario ja registrado com este e-mail."
  }
  ```
</ResponseExample>