Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.lovi.ai/llms.txt

Use this file to discover all available pages before exploring further.

Create Campaign Form É aqui que tudo se junta: o público (seu CSV), a mensagem (seu template) e o momento exato. Este formulário é seu Centro de Lançamento. Vamos configurá-lo campo por campo para garantir que a mensagem chegue às pessoas certas, no momento certo.

​
📝 1. Configuração de Lançamento (Os Campos)

Preencha estes detalhes para definir a identidade da campanha:
  • Número de telefone: Selecione o número de onde as mensagens serão enviadas. Se você tem vários (Vendas, Suporte), escolha com cuidado.
  • Template de notificação: Escolha um dos seus templates aprovados.
    • Nota: Apenas templates que têm o sinal verde do Meta (Status: Aprovado) aparecerão.
  • Nome da campanha: Um nome para sua própria referência. Algo como Promo_Verao_2024.
  • Nome do evento: Um identificador técnico para o evento. Útil se você usa webhooks ou integrações externas para rastrear quando esta campanha específica é lançada.

​
⏰ 2. O Fator Tempo (Agendamento)

Tempo é relativo, mas em marketing é crítico.
  • Fuso Horário: Muito importante! 🌍 Selecione o fuso horário correto. Você não quer enviar uma mensagem de “Bom dia” às 3:00 da manhã porque selecionou o fuso horário errado.
  • Data de envio: Defina a data e hora exatas do envio.
    • O sistema agendará a entrega para aquele momento preciso.

​
👥 3. O Público (CSV de Usuários)

É aqui que você faz upload da lista de clientes 😄 Você deve enviar um arquivo .CSV (máximo 4MB) contendo os detalhes das pessoas que deseja contatar.

​
⚠️ A Regra de Ouro do CSV:

Para tudo funcionar, seu Excel/CSV deve seguir uma regra sagrada:
  1. Coluna number (Obrigatória): Deve haver uma coluna chamada exatamente number contendo os números de telefone com o código do país (ex.: 5511999998888). Sem esta coluna, o sistema não sabe quem contatar.
  2. Colunas de variáveis (Opcionais): Se seu template diz “Olá {{nome}}”, seu CSV deve ter uma coluna chamada nome. O sistema preencherá automaticamente as lacunas usando os dados de cada linha.

​
👁️ 4. Verificação (Template)

Na parte inferior você verá a seção Template. Ela não é editável; é apenas um lembrete visual para que você possa confirmar: “Ah sim, este é o template que quero enviar.” Certifique-se de que corresponde ao que você espera.

​
❗ 5. Erro: “Params Words Ratio Exceeds Limit” (templates com muitas variáveis)

Ocasionalmente, ao salvar ou validar um template/campanha, você pode encontrar um erro similar ao mostrado na captura de tela: Error screenshot A mensagem de erro geralmente diz algo como:
Invalid parameter - OAuthException - Params Words Ratio Exceeds Limit - This template has too many variables for its length. Reduce the number of variables or increase the message length.
O que isso significa? O Meta (WhatsApp) impõe regras sobre a proporção entre o número de variáveis em um template e o comprimento total da mensagem. Se um template contém muitas variáveis em relação ao total de palavras, a validação pode falhar. O que fazer (passos rápidos):
  1. Consulte os códigos de erro oficiais do Business Messaging para entender a causa exata e o código: https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes
  2. Revise o template e reduza variáveis desnecessárias:
    • Combine campos no CSV em uma única coluna antes de enviar (por exemplo, use nome_completo em vez de primeiro_nome + sobrenome).
    • Substitua múltiplas variáveis pequenas por uma única variável mais ampla (por exemplo, {{1}} = “João Silva, cliente VIP”).
  3. Aumente o comprimento da mensagem se possível (adicione texto descritivo não sensível), para melhorar a proporção palavras-para-variáveis.
  4. Se você realmente precisa de muitas variáveis, considere criar vários templates com menos variáveis cada e selecione o mais apropriado por segmento.
  5. Teste o template em um ambiente de staging ou com um número controlado de telefones antes de lançar em produção.
Dicas práticas:
  • Evite usar variáveis para conteúdo que é constante e poderia ser escrito diretamente no template.
  • Valide o CSV: certifique-se de que os nomes das colunas de variáveis correspondem exatamente aos referenciados pelo template.
  • Adicione uma breve nota técnica à sua biblioteca de templates (por exemplo: “usa campos: nome_completo, id_pedido”) para que colegas preparando CSVs o façam corretamente.

​
🚀 Fogo! (Salvar)

Quando você clicar em Salvar, a campanha é Agendada. Ela não sairá imediatamente (a menos que você tenha selecionado o horário atual); em vez disso, esperará pacientemente na fila até a Data de envio. Você pode ir ao módulo de Campanhas (o que vimos anteriormente) para vê-la com o status “Pendente” até chegar sua hora. Tudo pronto! Configure, envie sua lista e aguarde os resultados. 📈