Convite de evento no WhatsApp pela API: data, local e link de chamada na conversa

Pela API não oficial do WhatsApp você envia um convite de evento nativo — com nome, descrição, data, hora e local — usando POST /{key}/message/event. O convidado vê tudo dentro da conversa, sem link externo. Para eventos online, você gera um link de chamada com POST /{key}/message/create-call-link e completa o convite. Webinars, aulas, reuniões, consultas em grupo e encontros presenciais cabem no mesmo fluxo.

Todo evento sofre com os mesmos problemas: gente que não anotou a data, que esqueceu o horário, que não sabe onde é, que perdeu o link. O convite nativo resolve os três primeiros num só envio, e o link de chamada resolve o quarto. Este guia mostra como montar isso por código.

A camada não oficial da WAME é independente e não é afiliada, endossada ou suportada pelo WhatsApp ou pela Meta. O uso é de responsabilidade de quem envia.

Por que usar a mensagem de evento em vez de texto

Você poderia mandar um texto: "Workshop dia 15/10 às 19h, na Rua X". Funciona, mas o evento nativo tem vantagens concretas:

• Formato reconhecível. O convite aparece como um cartão de evento, não perdido no meio de outras mensagens.
• Dados estruturados. Nome, data, hora e local em campos próprios, e não num texto que cada um interpreta de um jeito.
• Menos pergunta repetida. "Que horas é mesmo?" e "onde fica?" diminuem porque a resposta está no convite.
• Funciona em grupo. Um envio para o grupo da turma ou do evento resolve para todo mundo.

É um daqueles recursos que a camada não oficial expõe por conectar como um aparelho — o panorama completo está em recursos da API não oficial.

Enviar um convite de evento presencial

curl -X POST "https://us.api-wa.me/SUA_KEY/message/event" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5511999999999",
    "name": "Workshop de Automação no WhatsApp",
    "description": "Duas horas de prática com a API. Traga o notebook carregado.",
    "startTime": "2026-10-15T19:00:00-03:00",
    "locationName": "Espaço Coworking Centro",
    "locationAddress": "Av. Paulista, 1000 - Bela Vista, São Paulo - SP"
  }'

Os campos:

Atenção ao fuso no startTime. Um horário sem fuso, ou com Z no fim, é interpretado como UTC — o evento das 19h vira 16h para quem está em Brasília. Sempre inclua o deslocamento (-03:00) ou gere a data a partir de uma biblioteca que já trate fuso. É o erro mais comum nesse endpoint.

Se quiser reforçar o endereço com um pin clicável, mande em seguida uma localização — o guia está em localização no WhatsApp pela API.

Evento online: convite com link de chamada

Para aula, mentoria, reunião ou consulta online, o local é um link. A API gera links de chamada do próprio WhatsApp:

# Gera um link de chamada de vídeo (sem enviar para ninguém)
curl -X POST "https://us.api-wa.me/SUA_KEY/message/create-call-link" \
  -H "Content-Type: application/json" \
  -d '{ "type": "video" }'

O link gerado vai na descrição do convite. Se preferir mandar o link separado, perto do horário, use POST /{key}/message/call-link, que envia o convite de chamada direto para o contato. Assim o participante entra na chamada sem instalar nada — ele já está no WhatsApp.

Um fluxo em Node que cria o link e manda o convite:

const BASE = 'https://us.api-wa.me/SUA_KEY';

async function post(path, body) {
  const r = await fetch(`${BASE}${path}`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(body),
  });
  return r.json();
}

async function convidarAulaOnline(telefone, aula) {
  // A resposta traz o link pronto no campo `link`.
  const { link: url } = await post('/message/create-call-link', { type: 'video' });

  await post('/message/event', {
    to: telefone,
    name: aula.titulo,
    description: `${aula.resumo}\n\nEntre pela chamada: ${url}`,
    startTime: aula.inicioISO, // ex.: "2026-10-20T20:00:00-03:00"
  });
}

Para uma turma inteira, em vez de convidar pessoa por pessoa, mande um convite no grupo da turma — é mais simples e muito mais natural. O modelo de grupos por turma e comunidade está em criar e gerenciar comunidade pela API.

Lembretes: o que realmente reduz a falta

O convite resolve a informação; o lembrete resolve o esquecimento. Uma sequência que funciona bem:

1. Na inscrição: convite de evento com todos os dados.
2. Um dia antes: texto curto — "Amanhã às 19h tem o workshop. Confirma presença? Responda SIM ou NÃO."
3. Uma hora antes: para eventos online, o link de chamada de novo; para presenciais, o pin do local.
4. Depois do evento: agradecimento e, se fizer sentido, uma pesquisa de satisfação com enquete.

Quem responde "NÃO" sai da sequência. Isso tem dois efeitos: libera a vaga para outro inscrito e mantém suas mensagens indo só para quem quer recebê-las. A mesma lógica de agendamento, aplicada a consultas, está em lembrete de agendamento no WhatsApp.

Um cuidado de engenharia: se você tem trezentos inscritos, os lembretes de "um dia antes" não devem sair todos no mesmo segundo. Coloque numa fila e espalhe o envio ao longo de alguns minutos. A API já freia rajada — ela responde 429 quando a instância aborda números novos demais por minuto ou manda o mesmo texto para números demais —, mas o ideal é sua fila nunca chegar nesse freio. Personalizar a mensagem com o nome da pessoa ajuda duas vezes: fica mais humano e o texto deixa de ser idêntico. O desenho está em fila, rate limit e retry.

Convite em grupo x convite individual

No grupo, você ainda pode fixar a mensagem do convite no topo até o dia do evento — quem entra depois encontra a informação sem perguntar.

O que não fazer

• Convidar lista fria. Pegar uma base de contatos antiga e mandar convite de webinar para todo mundo é disparo não solicitado. Convite de evento continua sendo mensagem: se a pessoa não pediu, ela denuncia. A WAME não apoia esse uso, e é o caminho mais rápido para perder o número. As regras estão em uso responsável da API não oficial.
• Lembrete demais. Três mensagens bem posicionadas convertem; oito irritam.
• Esquecer o fuso. Já dito, mas vale repetir: o startTime sem deslocamento é o bug número um.
• Link de chamada público em grupo aberto. Em evento com vagas limitadas, mande o link só para confirmados, individualmente.

Conclusão

A mensagem de evento é o jeito mais limpo de levar data, hora e local para dentro da conversa: POST /{key}/message/event monta o convite nativo, create-call-link resolve eventos online, e uma sequência curta de lembretes para quem confirmou derruba a taxa de falta. Mandando para inscritos, alunos e participantes — gente que espera o convite —, é um uso tranquilo da API não oficial, com taxa de bloqueio muito baixa para quem usa do jeito certo. Os campos completos estão na documentação, e as outras vantagens da camada não oficial estão em API do WhatsApp não oficial: vantagens.