# Enviar evento / convite

`POST /send/event`

Pasta: **Enviar Mensagem**

## Autenticação

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

## Descrição

# Enviar convite de evento

Envia um convite de evento/calendário do WhatsApp (nome, horário, local, link e lembrete).

## Endpoint

```http
POST {{baseUrl}}/send/event
```

## Autenticação

Envie o token da instância no header:

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

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| number | string | Sim* | Destinatário |
| chatid | string | Sim* | Alternativa a number |
| name | string | Sim | Nome do evento |
| description | string | Não | Descrição |
| startTime | int | Sim | Início em Unix timestamp (segundos) |
| endTime | int | Não | Fim em Unix timestamp (segundos) |
| latitude | number | Não | Latitude do local (com longitude) |
| longitude | number | Não | Longitude do local (com latitude) |
| locationName | string | Não | Nome do local |
| locationAddress | string | Não | Endereço do local |
| joinLink | string | Não | Link de entrada (call/meet) |
| extraGuestsAllowed | bool | Não | Permite convidados extras |
| isScheduleCall | bool | Não | Marca como chamada agendada |
| hasReminder | bool | Não | Ativa lembrete |
| reminderOffsetSec | int | Não | Antecedência do lembrete em segundos |
| isCanceled | bool | Não | Marca evento como cancelado |

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/send/event" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{"number": "{{remoteJid}}", "name": "Reunião de time", "description": "Alinhamento semanal", "startTime": 1784500000, "endTime": 1784503600, "latitude": -23.55, "longitude": -46.63, "locationName": "Escritório", "locationAddress": "Av. Paulista, 1000", "joinLink": "https://meet.exemplo.com/abc", "hasReminder": true, "reminderOffsetSec": 900, "extraGuestsAllowed": false}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "message": {
    "id": "3EB0A1B2C3D4E5F6",
    "timestamp": "2026-07-17T12:34:56Z",
    "sender": "5511888888888@s.whatsapp.net"
  }
}
```

## Erros comuns

- `name is required`
- `startTime is required`
- Destinatário ausente

## Corpo (exemplo)

```json
{
  "number": "{{number}}",
  "name": "Reunião de time",
  "description": "Alinhamento semanal",
  "startTime": 1752800000,
  "endTime": 1752806400,
  "latitude": -23.55,
  "longitude": -46.63,
  "locationName": "Escritório",
  "joinLink": "https://meet.example.com/abc",
  "hasReminder": true,
  "reminderOffsetSec": 3600
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/send/event" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "number": "{{number}}",
  "name": "Reunião de time",
  "description": "Alinhamento semanal",
  "startTime": 1752800000,
  "endTime": 1752806400,
  "latitude": -23.55,
  "longitude": -46.63,
  "locationName": "Escritório",
  "joinLink": "https://meet.example.com/abc",
  "hasReminder": true,
  "reminderOffsetSec": 3600
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=enviar-mensagem/enviar-evento-convite)