Usuários

A API de usuários permite gerenciar os usuários da sua empresa, incluindo cadastro, edição, desativação e restauração.

Listar Usuários

GET https://chat.mehub.app/api/v1/users

Retorna uma lista paginada de todos os usuários da empresa.

Headers

Nome	Tipo	Obrigatório	Descrição
Authorization	string	Sim	Token de autenticação. Ex: Bearer seu_token

Query Parameters

Nome	Tipo	Obrigatório	Descrição
page	integer	Não	Número da página. Default: 1
per_page	integer	Não	Registros por página (máx: 100). Default: 20
search	string	Não	Buscar por nome
type	string	Não	Filtrar por tipo: admin, user
status	string	Não	Filtrar por status: active (ativos), inactive (desativados)

Exemplo de requisição

curl -X GET "https://chat.mehub.app/api/v1/users?type=user&status=active" \
  -H "Authorization: Bearer SEU_TOKEN"

Response

{
  "success": true,
  "data": [
    {
      "id": 37,
      "name": "Ana Silva",
      "email": "[email protected]",
      "type": "user",
      "signature": "Ana Silva",
      "signature_active": true,
      "avatar": null,
      "external_reference": null,
      "company_id": 1,
      "created_at": "2025-10-23T15:01:02.000000Z",
      "updated_at": "2025-10-23T15:01:02.000000Z",
      "deleted_at": null
    }
  ],
  "pagination": {
    "total": 50,
    "per_page": 20,
    "current_page": 1,
    "last_page": 3
  }
}

Visualizar Usuário

GET https://chat.mehub.app/api/v1/users/{id}

Retorna os dados de um usuário específico.

Headers

Nome	Tipo	Obrigatório	Descrição
Authorization	string	Sim	Token de autenticação. Ex: Bearer seu_token

Path Parameters

Nome	Tipo	Obrigatório	Descrição
id	integer	Sim	ID do usuário

Exemplo de requisição

curl -X GET "https://chat.mehub.app/api/v1/users/5" \
  -H "Authorization: Bearer SEU_TOKEN"

Response

{
  "success": true,
  "data": {
    "id": 5,
    "name": "Maria Oliveira",
    "email": "[email protected]",
    "type": "user",
    "signature": "Maria Oliveira",
    "avatar": "https://storage.exemplo.com/avatars/5_1750859909.png",
    "external_reference": null,
    "channels": [
      {
        "token": "abc123def456",
        "name": "WhatsApp Vendas",
        "type": "whatsapp"
      }
    ],
    "created_at": "2025-06-24T14:19:02.000000Z",
    "updated_at": "2025-10-28T18:09:50.000000Z"
  }
}

Cadastrar Usuário

POST https://chat.mehub.app/api/v1/users

Cria um novo usuário na empresa.

Headers

Nome	Tipo	Obrigatório	Descrição
Authorization	string	Sim	Token de autenticação. Ex: Bearer seu_token

Request Body

Nome	Tipo	Obrigatório	Descrição
name	string	Sim	Nome completo (máx: 50 caracteres, apenas letras e espaços)
email	string	Sim	E-mail (único por empresa)
password	string	Sim	Senha (mín: 8 caracteres)
type	string	Sim	Tipo: admin ou user
external_reference	integer	Não	Referência externa para integração
channels	array	Não	Lista de tokens dos canais que o usuário terá acesso

Usuários admin têm acesso a todos os canais. Usuários user têm acesso apenas aos canais informados em channels.

Exemplo de requisição

curl -X POST "https://chat.mehub.app/api/v1/users" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Eduardo Silva",
    "email": "[email protected]",
    "password": "senha12345",
    "type": "user",
    "external_reference": 54,
    "channels": ["abc123def456", "xyz789ghi012"]
  }'

Response

{
  "success": true,
  "message": "Usuário criado com sucesso.",
  "data": {
    "id": 29,
    "name": "Eduardo Silva",
    "email": "[email protected]",
    "type": "user",
    "signature": "Eduardo Silva",
    "avatar": null,
    "external_reference": 54,
    "channels": [
      {
        "token": "abc123def456",
        "name": "WhatsApp Vendas",
        "type": "whatsapp"
      },
      {
        "token": "xyz789ghi012",
        "name": "WhatsApp Suporte",
        "type": "whatsapp_unofficial"
      }
    ],
    "created_at": "2025-10-30T16:56:52.000000Z",
    "updated_at": "2025-10-30T16:56:52.000000Z"
  }
}

Erros

{
  "success": false,
  "errors": [
    {
      "code": "EMAIL_ALREADY_EXISTS",
      "message": "Este e-mail já está sendo usado por outro usuário da empresa."
    }
  ]
}

Editar Usuário

PUT https://chat.mehub.app/api/v1/users/{id}

Atualiza os dados de um usuário. Envie apenas os campos que deseja atualizar.

Headers

Nome	Tipo	Obrigatório	Descrição
Authorization	string	Sim	Token de autenticação. Ex: Bearer seu_token

Path Parameters

Nome	Tipo	Obrigatório	Descrição
id	integer	Sim	ID do usuário

Request Body

Nome	Tipo	Obrigatório	Descrição
name	string	Não	Nome completo
email	string	Não	E-mail
password	string	Não	Nova senha
type	string	Não	Tipo: admin ou user
external_reference	integer	Não	Referência externa
channels	array	Não	Tokens dos canais (substitui os anteriores)

Exemplo de requisição

curl -X PUT "https://chat.mehub.app/api/v1/users/29" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Eduardo Santos Silva",
    "type": "admin"
  }'

Response

{
  "success": true,
  "message": "Usuário atualizado com sucesso.",
  "data": {
    "id": 29,
    "name": "Eduardo Santos Silva",
    "email": "[email protected]",
    "type": "admin",
    "signature": "Eduardo Santos Silva",
    "avatar": null,
    "external_reference": 54,
    "channels": [],
    "created_at": "2025-10-30T16:56:52.000000Z",
    "updated_at": "2025-10-30T17:30:00.000000Z"
  }
}

Desativar Usuário

DELETE https://chat.mehub.app/api/v1/users/{id}

Desativa um usuário (soft delete). O usuário pode ser restaurado posteriormente.

Headers

Nome	Tipo	Obrigatório	Descrição
Authorization	string	Sim	Token de autenticação. Ex: Bearer seu_token

Path Parameters

Nome	Tipo	Obrigatório	Descrição
id	integer	Sim	ID do usuário

Exemplo de requisição

curl -X DELETE "https://chat.mehub.app/api/v1/users/29" \
  -H "Authorization: Bearer SEU_TOKEN"

Response

{
  "success": true,
  "message": "Usuário desativado com sucesso."
}

Restaurar Usuário

POST https://chat.mehub.app/api/v1/users/{id}/restore

Restaura um usuário previamente desativado.

Headers

Nome	Tipo	Obrigatório	Descrição
Authorization	string	Sim	Token de autenticação. Ex: Bearer seu_token

Path Parameters

Nome	Tipo	Obrigatório	Descrição
id	integer	Sim	ID do usuário

Exemplo de requisição

curl -X POST "https://chat.mehub.app/api/v1/users/29/restore" \
  -H "Authorization: Bearer SEU_TOKEN"

Response

{
  "success": true,
  "message": "Usuário ativado com sucesso."
}

Campos do Response

Campo	Tipo	Descrição
id	integer	ID único do usuário
name	string	Nome completo
email	string	E-mail
type	string	Tipo: admin ou user
signature	string	Assinatura nas mensagens
signature_active	boolean	Se a assinatura está ativa
avatar	string/null	URL da imagem de perfil
external_reference	integer/null	Referência externa
channels	array	Canais vinculados
deleted_at	datetime/null	Data de desativação