Avisos por SMS e WhatsApp

A comunidade pode mandar avisos por SMS e pelo WhatsApp: o lembrete do evento, o pagamento recusado, a pendência do ciclo de avaliação, o passo de um workflow. Só recebe quem consentiu e confirmou o celular com um código. O e-mail continua sendo o canal principal; o SMS e o WhatsApp são o recado que a pessoa vê a tempo.

Os dois canais funcionam do mesmo jeito: cada um se liga à parte, tem o seu teto, a sua cota e o seu consentimento. O WhatsApp tem duas diferenças: toda mensagem sai num modelo aprovado, e a Memberfy manda sozinha as mensagens da plataforma que a comunidade deixar ligadas.

#Para a equipe

#Ligar o canal

Papel: proprietário ou administrador.

Em Administração › Configurações › E-mails e notificações, os cartões SMS e WhatsApp:

1. Ligue Enviar avisos por SMS (ou Enviar avisos pelo WhatsApp).
2. Defina o Teto diário de mensagens, de 1 a 50.000 mensagens por dia. Ele é obrigatório: sem ele, o canal não liga ("Defina o teto diário para ligar o SMS."). Passado o teto, o resto sai no dia seguinte, às 8h.
3. Salvar.

Qual plano tem cada canal. O SMS vem a partir do Growth, e o WhatsApp está nos planos Business e Scale. Num plano sem o canal, o cartão diz "O WhatsApp está disponível a partir do plano Business.", com Ver planos, e o canal não liga. Ver as cotas em Plano e extensões.

Cada cartão mostra o Uso: Este mês, contra a cota do plano ("de N este mês"), e Hoje, contra o teto. No plano anual, o que sobra se acumula até a renovação ("N disponíveis até 31/03/2027 (acumula no plano anual)"). A cota do SMS e a do WhatsApp são separadas, e os códigos de confirmação do celular não entram na conta. O cartão do SMS mostra também as partes usadas: uma mensagem longa ou com acento ocupa mais de uma parte.

Desligar o canal vale também para o que ainda está na fila: esses envios são pulados.

#As regras de envio

Todo SMS sai com o nome da comunidade na frente ("[Clube de Corrida] Seu treino começa em 1 hora.") e o link para sair no fim.

#WhatsApp só em modelos aprovados

No WhatsApp não há texto livre: toda mensagem sai num modelo aprovado pelo WhatsApp, com um botão que abre a página certa da comunidade ("Ver ingresso", "Atualizar pagamento"). Os modelos de evento presencial trazem o local e um segundo botão, Ver no mapa. A Memberfy preenche o primeiro nome da pessoa e o nome da comunidade; os outros campos vêm do que aconteceu (o evento, o horário, o valor).

O cartão do WhatsApp mostra, em Modelos aprovados, cada modelo da Memberfy com a situação (Aprovado, Em análise, Recusado…), o tipo (Serviço ou Marketing) e para que serve. Os modelos são fixos e aprovados em português. Um modelo ainda não aprovado não sai: o envio é pulado ("o modelo ainda não está aprovado").

Num workflow, o bloco Enviar WhatsApp escolhe o modelo e preenche os campos dele; para um recado que não tem modelo próprio, use Aviso da comunidade, que leva o seu texto. Ver Enviar SMS e Enviar WhatsApp, com a lista dos modelos que um workflow pode usar.

#Modelos de marketing

O WhatsApp classifica alguns modelos como marketing, mesmo com texto de serviço: Aviso da comunidade (as duas versões), Feedback recebido (as duas versões), Compra não concluída, Menção e Conteúdo novo. O cartão mostra o tipo de cada um em Modelos aprovados. Esses modelos só chegam a quem aceitou novidades pelo WhatsApp; para os demais, o envio é pulado ("sem consentimento para WhatsApp"). Se o WhatsApp reclassificar um modelo depois, vale a classificação mais restrita.

Num workflow com um desses modelos, ponha um Enviar e-mail para quem não recebeu: depois do Enviar WhatsApp, uma condição "Variável" com {{steps.<bloco>.result}} igual a skipped leva ao e-mail. Assim todo mundo recebe o recado, por um canal ou pelo outro.

#Mensagens da plataforma no WhatsApp

Com o WhatsApp ligado, a Memberfy manda sozinha, sem workflow, as mensagens dos momentos abaixo para quem pode receber. Em Mensagens da plataforma, no cartão do WhatsApp, a comunidade desliga o que não quer enviar; cada pessoa desliga as suas em Minha Conta › Avisos, em O que chega pelo WhatsApp. Todas seguem as regras de envio: o plano Business ou Scale, o horário de silêncio no fuso de quem recebe, o teto diário, o limite por pessoa e a cota. Cada uma sai uma vez só para cada acontecimento.

As mensagens de evento vão só para quem se inscreveu ou tem ingresso, no máximo 3 por evento. As desligadas por padrão só chegam a quem as liga em Minha Conta › Avisos ("Só para quem ligar em Minha conta › Avisos").

#O teste

No fim de cada cartão, Teste para o meu celular (ou Teste para o meu WhatsApp) e o botão Enviar teste para mim: um aviso para o seu celular confirmado, com todas as regras. Ele conta no uso, como qualquer mensagem. O canal precisa estar ligado e salvo.

A resposta diz o que aconteceu:

• "Teste na fila: chega em instantes."
• "Teste na fila: sai em …", por causa do horário de silêncio ou do teto diário.
• "Teste não enviado: …", com o motivo (sem telefone, telefone não confirmado, sem consentimento…). Quando o motivo é seu, o link Ajustar em Minha conta › Perfil leva à sua conta: o número se confirma em Minha Conta › Conta e os canais se ligam em Minha Conta › Avisos.

#Onde os avisos são usados

• Workflows: os blocos Enviar SMS e Enviar WhatsApp, na categoria Mensagens. Ver Enviar SMS e Enviar WhatsApp.
• Mensagens da plataforma (WhatsApp): os momentos da tabela acima.
• Lembretes (SMS): com o SMS ligado, o lembrete do evento (1 hora antes), os lembretes do ciclo de PDI e o lembrete da 1:1 também saem por SMS. Ver Lembretes que também vão por SMS.

#O consentimento de cada membro

No perfil de um membro, o proprietário e o administrador veem cada consentimento em vigor, por canal: "SMS (avisos): consentiu em 27/10, origem cadastro". A origem é cadastro, login, importação, Minha conta ou declarado pela equipe. Sem consentimento, "SMS: sem consentimento".

#Consentimento declarado pela equipe

Quando a comunidade coletou o consentimento de SMS ou de WhatsApp fora da Memberfy (a ficha de inscrição de um encontro, um formulário assinado), o proprietário ou o administrador registra esse consentimento para quem já é membro, pela API ou pelo assistente. Para pessoas novas, ou uma lista grande, use a importação por planilha, que agora também vale para quem já é membro.

• A declaração é da comunidade. Quem registra declara que a comunidade coletou o consentimento de cada pessoa da lista, e a responsabilidade por essa declaração é da comunidade.
• Para quê: os avisos de serviço, as novidades (marketing) ou os dois, em um canal ou nos dois. Opcionalmente, quando o consentimento foi coletado e como ("ficha de inscrição do encontro de outubro").
• Até 200 membros por vez, cada um com o celular, se quiser. O resultado vem pessoa por pessoa: registrado, já tinha consentimento, consentimento retirado, número inválido, não encontrado.
• O que fica registrado: cada consentimento com a origem declarado pela equipe, quem declarou, quando e como, e uma linha no log da comunidade.
• O celular informado pela equipe já recebe. O telefone que a equipe informa ao declarar o consentimento (aqui ou na importação com a declaração) recebe SMS e WhatsApp sem a confirmação por código.
• Mas não fica confirmado. Os códigos de confirmação continuam exigindo que a própria pessoa confirme o número, e é ela quem confirma o número, em Minha Conta › Conta, para ligar o canal.
• Vale enquanto for o telefone atual do perfil. Um número trocado depois não herda a declaração, e um número gravado depois sem declaração também a perde. Se a pessoa já confirmou outro número, ele fica.
• Quem saiu nunca volta assim. Quem saiu do canal (pelo link, pelo SAIR ou pelo botão do Perfil) ou retirou o consentimento não é recadastrado.
• O administrador não declara pelo proprietário, nem pela importação. O registro para o proprietário só pode ser feito por ele mesmo.

A pessoa continua podendo sair a qualquer momento (inclusive respondendo SAIR ou STOP), e o consentimento por canal, o horário de silêncio, os tetos e as demais regras de envio valem do mesmo jeito.

#Para os membros

#O consentimento

• No cadastro: o campo Celular (opcional) e, ao lado do botão, o texto do aviso de serviço: "Ao continuar, você aceita receber por SMS avisos de serviço da comunidade Clube de Corrida (lembretes e pendências). Para parar, use o link da mensagem." O texto do WhatsApp diz o mesmo, com "Para parar, responda SAIR." Criar a conta aceita os avisos de serviço. As novidades da comunidade a pessoa liga depois, no botão do canal em Minha Conta › Avisos.
• No login: o mesmo texto de serviço aparece ao lado de Entrar, uma vez por comunidade e por versão do texto. Entrar é aceitar; o texto nunca impede o login.
• Na importação: a pessoa só recebe SMS se a planilha trouxer a coluna de consentimento de SMS com um "sim" e quem importou atestar que a comunidade coletou esse consentimento. Vale para quem a importação cria e para quem já é membro. Ver Importar membros por planilha. Na tela, a importação não traz consentimento de WhatsApp (pela API e pelo assistente, traz).
• Pela equipe: o proprietário ou o administrador registra o consentimento que a comunidade coletou. Ver Consentimento declarado pela equipe.

Se o texto do consentimento mudar, o que a pessoa aceitou continua valendo para o que ele cobria.

#Minha Conta › Conta e Avisos: o celular e os canais

Em Minha Conta › Conta, logo abaixo de Telefone, fica a confirmação do celular; em Minha Conta › Avisos, o cartão Celular: SMS e WhatsApp ("Ligue cada canal para receber os avisos no seu número confirmado.") tem um botão por canal:

1. Salve o telefone. Um número ainda não salvo mostra "Salve o número para confirmá-lo."
2. Com o número salvo, aparece "Celular não confirmado" e o botão Confirmar número. Ele manda um código de 6 números pelo WhatsApp, quando a comunidade usa o WhatsApp, ou por SMS, quando não usa ("Enviamos um código de 6 números pelo WhatsApp para …"). O código vale 10 minutos e aceita 5 tentativas; Reenviar código fica disponível depois de 1 minuto, e são no máximo 3 códigos por hora para o mesmo número.
3. Digite o código e clique em Confirmar: "Telefone confirmado." O mesmo celular vale para o SMS e para o WhatsApp.
4. Ligue o canal: Receber avisos e novidades por SMS e, abaixo, Receber avisos e novidades pelo WhatsApp ("Lembretes, ingressos, pendências e novidades da comunidade."). Enquanto o número não está confirmado, o botão fica desativado ("Confirme o número primeiro").

Ligar um canal autoriza de uma vez os lembretes, ingressos, pendências e novidades da comunidade por aquele canal, com a origem Minha conta. Desligar para os avisos e as novidades daquele canal. No fim do quadro: "Para parar, responda SAIR ou desligue aqui." A escolha vale só para a comunidade em que você está. O botão de um canal que a comunidade ainda não usa não aparece.

Depois do cadastro com celular, a tela Confirme seu celular pede o código logo de cara. Agora não deixa para depois, em Minha Conta › Conta. O número só passa a valer na conta depois do código; trocar o telefone desfaz a confirmação.

#Minha Conta › Avisos

Em Minha Conta, na seção Avisos, ficam só as escolhas de assunto:

• Avisos desta comunidade, com as categorias de cada canal: E-mail (as de E-mails desta comunidade), SMS e WhatsApp (em Por assunto);
• O que chega pelo WhatsApp: cada mensagem da plataforma, para ligar ou desligar. A de compra não concluída pede as novidades ("Precisa aceitar novidades pelo WhatsApp em Minha conta › Perfil.").

Os botões para ligar e desligar cada canal ficam na mesma seção, no cartão Celular: SMS e WhatsApp. Se a comunidade ainda não envia por um canal, o quadro diz isso.

#Parar de receber

Responder VOLTAR desfaz o SAIR, no mesmo canal. Também valem PARAR, STOP e CANCELAR para sair, e START para voltar. Para sair de uma comunidade só, use o link do SMS ou o botão do canal em Minha Conta › Avisos: o SAIR vale para o número inteiro.

#Exemplos

Corrida de rua com lembrete no celular. A organização liga o SMS com teto de 2.000 por dia. Quem se inscreve na prova e confirmou o celular recebe, 1 hora antes, "[Clube de Corrida] Largada às 7h, portão 3.", junto do lembrete por e-mail.

Conferência com participantes de fora. No plano Business, a organização liga o WhatsApp. Quem tem ingresso recebe o Lembrete 24 h antes do evento com o local e o botão Ver no mapa, e o Evento começando, 30 minutos antes. O palestrante de Lisboa recebe no horário de Lisboa: nada sai para ele entre 21h e 8h de lá.

RH com pendência no WhatsApp. A empresa liga o WhatsApp e deixa ligada Pendências de RH: quem tem a autoavaliação pendente recebe o aviso com o botão que abre a avaliação. Para um recado próprio, um workflow usa o modelo Aviso da comunidade com "{{member.first_name}}, a reunião geral mudou para as 15h." Como esse modelo é de marketing, um Enviar e-mail logo depois avisa quem não aceitou novidades pelo WhatsApp.

#Erros comuns e como resolver

#Perguntas frequentes

O telefone é obrigatório? Não. Sem celular, nada é enviado por SMS nem pelo WhatsApp.

Funciona fora do Brasil? Sim. O envio vale para todos os países; por enquanto, só o SMS para os Estados Unidos fica de fora. O horário de silêncio segue o fuso de quem recebe.

Quem foi importado recebe? Sim, com a coluna de consentimento marcando "sim" e a atestação de quem importou, e o telefone da planilha já recebe, sem a confirmação por código. Na tela, só o SMS; pela API e pelo assistente, também o WhatsApp.

Coletei o consentimento numa ficha em papel. Dá para registrar? Dá, para quem já é membro: o proprietário ou o administrador registra pela API ou pelo assistente, declarando que a comunidade coletou. Ver Consentimento declarado pela equipe.

Por que pedem um código? Para confirmar que o celular é seu antes da primeira mensagem. O código chega pelo WhatsApp quando a comunidade usa o WhatsApp, e por SMS quando não usa.

Respondi SAIR e parei de receber SMS de outra comunidade. O SAIR vale para o número em todas as comunidades. Responda VOLTAR e, se quiser sair só de uma, use o link do SMS ou o botão do canal em Minha Conta › Avisos dela.

Dá para escrever o texto do WhatsApp do meu jeito? Só dentro do modelo Aviso da comunidade, num workflow. O WhatsApp não aceita texto fora de um modelo aprovado. Esse modelo é de marketing: chega só a quem aceitou novidades pelo WhatsApp, então mande o mesmo recado por e-mail para os demais.

Dá para mandar uma campanha por SMS ou WhatsApp? Não. As campanhas são por e-mail. No WhatsApp, só a mensagem de compra não concluída e os modelos de marketing, para quem aceitou novidades.

Um aviso caiu às 22h. Ele se perde? Não: espera até as 8h, no fuso de quem recebe. Só o lembrete de evento, de PDI e de 1:1, que perderia o sentido atrasado, é pulado no SMS (o e-mail sai normalmente).

#Pelo assistente (MCP)

O proprietário e o administrador leem e mudam os canais (get_sms_settings, update_sms_settings, que também muda o limite por pessoa com person_daily_cap, get_whatsapp_settings, update_whatsapp_settings, que liga e desliga as mensagens da plataforma com moments; ligar exige o teto diário), veem os modelos (list_whatsapp_templates) e mandam o teste para o próprio celular (send_sms_test, send_whatsapp_test), que pedem confirmação porque mandam uma mensagem de verdade. A equipe conta as partes de um texto (count_sms_segments). Cada pessoa vê e muda os próprios avisos (get_my_notice_preferences, update_my_notice_preferences, com as mensagens do WhatsApp em whatsapp.moments e as novidades em whatsapp.marketing), vê os próprios consentimentos (list_my_contact_consents) e confirma o celular (request_phone_verification, confirm_phone_verification). O proprietário e o administrador veem os consentimentos de um membro (list_member_contact_consents), nunca o IP, e registram o consentimento que a comunidade declara ter coletado (attest_contact_consent, que pede confirmação). Ver Ferramentas · Comunidade e Ferramentas · Membros.

#Na API

GET e PUT /api/sms/settings e /api/whatsapp/settings (ligar exige dailyCap, de 1 a 50.000; sem ele, 422 com param: "dailyCap"; personDailyCap, de 1 a 20, no SMS; moments no WhatsApp; availableOnPlan, blockedCountries e o medidor quota na leitura), POST /api/sms/test e /api/whatsapp/test (202, com queued ou skipped e o motivo), GET /api/whatsapp/templates e POST /api/sms/segments (as partes e a codificação do texto sozinho e como sai). Ligar o WhatsApp num plano sem ele: 403 whatsapp.notOnPlan. Da própria conta: POST /api/members/me/phone-verification e .../confirm, GET e PUT /api/members/me/notice-preferences (channels.email, channels.sms, channels.whatsapp, com whatsapp.moments e whatsapp.marketing) e GET /api/members/me/contact-consents. Da equipe: GET /api/members/{memberId}/contact-consents e POST /api/contact-consent/attestations (proprietário e administrador: attestation: true, channels, purpose service, marketing ou all, collectedAt e collectionMethod opcionais, e members, até 200, com memberId e phone opcional; o resultado traz, por membro, o status, phoneVerified e sendable, se o telefone atual já pode receber). Os textos de consentimento: GET /api/contact-consent/texts. O cadastro e o login aceitam smsConsent (service, marketing e whatsapp); a importação, os destinos smsConsent e whatsappConsent, com a atestação. Ver Ordem de criação › SMS e WhatsApp e Respostas e erros.

#Relacionados

• Workflows
• E-mails desta comunidade
• Importar membros por planilha
• Plano e extensões
• Configurações da comunidade