# Entrar em grupo via mensagem de convite

`POST /group/invite-join`

Pasta: **Grupos e Comunidades**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Entrar em grupo via mensagem de convite

Entra em um grupo utilizando os dados de uma mensagem de convite (v4) recebida. Diferente de um código de convite ativo genérico, este endpoint consome o convite específico que chegou por mensagem.

## Endpoint

`POST {{baseUrl}}/group/invite-join`

## Autenticação

Envie o token da instância no header `token: {{token}}`.

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `jid` | string | Sim* | JID do grupo (`...@g.us`) presente na mensagem de convite. Alias `group`. |
| `group` | string | Sim* | Alias de `jid`. |
| `inviter` | string | Sim* | JID de quem enviou o convite. Alias `admin`. |
| `admin` | string | Sim* | Alias de `inviter`. |
| `code` | string | Sim | Código do convite (v4) presente na mensagem recebida. |
| `expiration` | integer | Não | Timestamp Unix de expiração do convite, presente na mensagem recebida. |

## Exemplo de Requisição

```bash
curl --request POST '{{baseUrl}}/group/invite-join' \
  --header 'token: {{token}}' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "jid": "123456789012345@g.us",
  "inviter": "5511999999999@s.whatsapp.net",
  "code": "ABCDEF1234",
  "expiration": 1735689600
}'
```

## Resposta de Sucesso

```json
{
  "success": true
}
```

## Erros comuns

- `401 Unauthorized`: o header `token` não foi enviado ou é inválido.
- `400 Bad Request`: o JSON está malformado ou contém um identificador inválido.
- `500 Internal Server Error`: a conexão com o WhatsApp falhou ou a operação foi recusada.

## Observações

* Informe `jid` (ou `group`) e `inviter` (ou `admin`). Use `POST /group/invite-info` antes, para pré-visualizar o grupo sem entrar.

## Corpo (exemplo)

```json
{
  "jid": "123456789012345@g.us",
  "inviter": "5511999999999@s.whatsapp.net",
  "code": "ABCDEF1234",
  "expiration": 1735689600
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/group/invite-join" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "jid": "123456789012345@g.us",
  "inviter": "5511999999999@s.whatsapp.net",
  "code": "ABCDEF1234",
  "expiration": 1735689600
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=grupos-e-comunidades/entrar-em-grupo-via-mensagem-de-convite)