--- title: "Convite de evento no WhatsApp pela API" 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://api-wa.me/blog/convite-evento-whatsapp-api" language: "pt-BR" og:type: "article" og:site_name: "WAME API" --- [Início](https://api-wa.me/)/[Blog da API do WhatsApp](https://api-wa.me/blog)/Convite de evento no WhatsApp pela API: data, local e link de chamada na conversa Raphael Serafim· Publicado em 28 de setembro de 2026· 8 min de leitura Compartilhar # 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. Copiar para LLM[Ver como Markdown](https://api-wa.me/blog/convite-evento-whatsapp-api.md) **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](https://api-wa.me/blog/api-nao-oficial-whatsapp-recursos-exemplos). ## Enviar um convite de evento presencial bash Copiar ``` 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: | 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](https://api-wa.me/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 Copiar ``` # 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: javascript Copiar ``` 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](https://api-wa.me/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](https://api-wa.me/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](https://api-wa.me/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](https://api-wa.me/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](https://api-wa.me/blog/automatizar-grupos-whatsapp-api) | No grupo, você ainda pode [fixar a mensagem do convite](https://api-wa.me/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](https://api-wa.me/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](https://api-wa.me/docs), e as outras vantagens da camada não oficial estão em [API do WhatsApp não oficial: vantagens](https://api-wa.me/blog/api-whatsapp-nao-oficial-vantagens). ### Pronto para automatizar seu WhatsApp? Crie sua conta gratuita e comece a enviar mensagens pela API em minutos. [Começar grátis](https://portal.api-wa.me/sign-up) ## 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. ## Continue lendo [### Agente de voz no WhatsApp: latência, interrupção (barge-in) e silêncio Como deixar um agente de voz no WhatsApp natural: latência, streaming, detecção de fala, interrupção (barge-in), silêncio e eco, com exemplos em Node.js.](https://api-wa.me/blog/agente-voz-whatsapp-latencia-interrupcao)[### Anti-detecção na API não oficial do WhatsApp: como a WAME protege seu número Como funciona a camada de anti-detecção da API não oficial da WAME: identidade de dispositivo, tempo humano, ritmo de envio, reconexão e monitor de saúde.](https://api-wa.me/blog/anti-deteccao-api-whatsapp-nao-oficial)[### API do WhatsApp em C# (.NET): enviar mensagens e receber webhook Tutorial de API do WhatsApp em C# e .NET: HttpClient tipado, envio de texto, imagem e lista, webhook em ASP.NET Core com fila em background e tratamento de 429.](https://api-wa.me/blog/api-whatsapp-csharp-dotnet) [Voltar ao blog](https://api-wa.me/blog) ## Structured data ```json { "@context": "https://schema.org", "@type": "WebSite", "name": "WAME API", "alternateName": "API Oficial e Não Oficial de WhatsApp, Instagram, Messenger e Telegram", "url": "https://api-wa.me", "inLanguage": "pt-BR", "publisher": { "@id": "https://api-wa.me/#organization", "@type": "Organization", "name": "WAME API", "url": "https://api-wa.me" } } { "@context": "https://schema.org", "@type": "Organization", "@id": "https://api-wa.me/#organization", "name": "WAME API", "alternateName": [ "WAME", "Wame API", "wame.api.br", "api-wa.me" ], "url": "https://api-wa.me", "logo": { "@type": "ImageObject", "url": "https://api-wa.me/images/web-app-manifest-512x512.png", "width": 512, "height": 512 }, "disambiguatingDescription": "WAME API é uma empresa brasileira de software, fundada em 2017 e parceira oficial da Meta (Meta Business Partner), que fornece APIs de WhatsApp, Instagram Direct e Messenger. Não tem relação com o wa.me, que é o encurtador de links operado pela WhatsApp LLC.", "identifier": { "@type": "PropertyValue", "propertyID": "INPI-BR", "name": "Pedido de registro de marca (INPI, classe NCL 42)", "value": "944724159" }, "foundingDate": "2017", "slogan": "Parceira Oficial da Meta — WhatsApp, Instagram, Messenger e Telegram numa instância só. Desde 2017.", "description": "Plataforma brasileira e Parceira Oficial da Meta (Meta Business Partner) para as APIs oficiais de WhatsApp (Cloud API), Instagram Direct e Messenger — os três numa única instância, com os mesmos endpoints e um único formato de webhook. Também oferece a API não oficial via QR Code e o Telegram, na mesma plataforma. No mercado desde 2017, com mais de 50 mil instâncias criadas, 99,9% de uptime e suporte humano 24/7 em português. SDKs oficiais para Node.js/TypeScript e PHP.", "knowsAbout": [ "WhatsApp Cloud API oficial (Meta)", "API oficial de Instagram (Direct)", "API oficial de Messenger", "API multicanal Meta", "Meta Business Partner", "WhatsApp API", "API não oficial de WhatsApp", "automação de WhatsApp", "números virtuais", "webhooks" ], "sameAs": [ "https://github.com/wame-api", "https://www.linkedin.com/company/wameapi", "https://www.instagram.com/wame.api/", "https://www.youtube.com/@wameapi" ], "contactPoint": { "@type": "ContactPoint", "contactType": "customer support", "url": "https://api-wa.me/contact", "availableLanguage": [ "Portuguese" ] } } { "@context": "https://schema.org", "@type": "BlogPosting", "headline": "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.", "image": "https://api-wa.me/blog/convite-evento-whatsapp-api/opengraph-image", "datePublished": "2026-09-28", "dateModified": "2026-09-28", "author": { "@type": "Person", "name": "Raphael Serafim", "url": "https://github.com/raphaelvserafim", "sameAs": [ "https://github.com/raphaelvserafim" ] }, "publisher": { "@type": "Organization", "name": "api-wa.me", "logo": { "@type": "ImageObject", "url": "https://api-wa.me/images/screenshot.png" } }, "mainEntityOfPage": { "@type": "WebPage", "@id": "https://api-wa.me/blog/convite-evento-whatsapp-api" }, "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", "inLanguage": "pt-BR" } { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://api-wa.me" }, { "@type": "ListItem", "position": 2, "name": "Blog da API do WhatsApp", "item": "https://api-wa.me/blog" }, { "@type": "ListItem", "position": 3, "name": "Convite de evento no WhatsApp pela API: data, local e link de chamada na conversa", "item": "https://api-wa.me/blog/convite-evento-whatsapp-api" } ] } { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "O que é a mensagem de evento do WhatsApp?", "acceptedAnswer": { "@type": "Answer", "text": "É 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." } }, { "@type": "Question", "name": "Como enviar um convite de evento pela API?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "Dá para convidar para um evento online?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "Posso mandar convite de evento para qualquer pessoa?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "Como mandar lembrete antes do evento?", "acceptedAnswer": { "@type": "Answer", "text": "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." } } ] } ```