--- title: "Convite de evento no WhatsApp pela API: data, local e link de chamada na conversa" description: "Como enviar convite de evento nativo no WhatsApp pela API não oficial: nome, data, local, link de chamada para eventos online e lembretes sem spam." url: "https://wame.api.br/blog/convite-evento-whatsapp-api" language: "pt-BR" og:type: "article" published_time: "2026-09-28" modified_time: "2026-09-28" author: "Raphael Serafim" keywords: "api whatsapp não oficial, api não oficial whatsapp, convite evento whatsapp api, evento whatsapp api, enviar evento whatsapp, lembrete evento whatsapp, whatsapp event message" reading_time: "8 min de leitura" --- # Convite de evento no WhatsApp pela API: data, local e link de chamada na conversa > Como enviar convite de evento nativo no WhatsApp pela API não oficial: nome, data, local, link de chamada para eventos online e lembretes sem spam. **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](/blog/api-nao-oficial-whatsapp-recursos-exemplos). ## Enviar um convite de evento presencial ```bash curl -X POST "https://server.wame.api.br/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: | Campo | Para que serve | | --- | --- | | `to` | Contato (telefone com DDI), grupo (`@g.us`) ou LID | | `name` | Nome do evento, o título do cartão | | `description` | O que é, o que levar, regras | | `startTime` | Data e hora em ISO 8601 | | `locationName` | Nome do lugar | | `locationAddress` | Endereço completo | **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](/blog/localizacao-whatsapp-api-enviar-pedir-tempo-real). ## 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: ```bash # Gera um link de chamada de vídeo (sem enviar para ninguém) curl -X POST "https://server.wame.api.br/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: ```js const BASE = 'https://server.wame.api.br/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](/blog/tutorial-criar-comunidade-whatsapp-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](/blog/pesquisa-satisfacao-enquete-whatsapp-api). 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](/blog/lembretes-agendamento-confirmacao-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](/blog/fila-rate-limit-retry-disparo-whatsapp). ## Convite em grupo x convite individual | Situação | Melhor caminho | | --- | --- | | Turma, comunidade, equipe | Um convite no grupo | | Inscritos de um evento aberto | Convite individual, logo após a inscrição | | Consulta ou mentoria 1:1 | Convite individual com link de chamada | | Evento grande e recorrente | Grupo de avisos com [envio só de admins](/blog/automatizar-grupos-whatsapp-api) | No grupo, você ainda pode [fixar a mensagem do convite](/blog/fixar-mensagem-whatsapp-api) 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](/blog/uso-responsavel-api-whatsapp-nao-oficial-spam). - **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](/docs), e as outras vantagens da camada não oficial estão em [API do WhatsApp não oficial: vantagens](/blog/api-whatsapp-nao-oficial-vantagens). ## Perguntas frequentes ### O que é a mensagem de evento do WhatsApp? É um tipo de mensagem nativo do WhatsApp que mostra um convite com nome, descrição, data e hora e local do evento, direto na conversa. Quem recebe vê os detalhes no próprio chat, sem precisar abrir link externo. ### Como enviar um convite de evento pela API? Faça POST /{key}/message/event com to, name, description, startTime em formato ISO 8601 (por exemplo 2026-10-15T19:00:00-03:00) e, se for presencial, locationName e locationAddress. Funciona para contato individual e para grupo. ### Dá para convidar para um evento online? Sim. Gere um link de chamada de áudio ou vídeo com POST /{key}/message/create-call-link e coloque o link na descrição do evento, ou envie o link separado com POST /{key}/message/call-link perto do horário. ### Posso mandar convite de evento para qualquer pessoa? Envie para quem se inscreveu, é aluno, cliente ou participante do grupo do evento. Convite em massa para quem não pediu é spam, é denunciado e derruba número. A WAME não apoia esse uso. ### Como mandar lembrete antes do evento? Agende no seu sistema um envio para cada inscrito, por exemplo um dia antes e uma hora antes, com /message/text ou reenviando o convite. Espalhe os envios no tempo e mande só para quem confirmou presença.