Modelos da API do WhatsApp Business: como criar e usar
Conteúdo

Os modelos da API do WhatsApp Business são formatos de mensagem pré-aprovados que usa para a primeira mensagem a um contacto ou quando a sessão de 24 horas expirou. Com a Spoki cria, submete e envia modelos para que a sua mensageria WhatsApp cumpra as regras da API.
Este guia explica como criar e usar os modelos da API do WhatsApp Business: o que são, quando são necessários, regras de sessão e melhores práticas. Encontrará ligações para registro, preços, suporte, marcar e a calculadora ROI.
O que são os modelos da API do WhatsApp Business?
Os modelos são formatos de mensagem que o WhatsApp aprova antes de poder enviá-los. Têm uma estrutura fixa com variáveis opcionais (ex. {{1}}, {{2}}). Usa modelos quando:
- envia a primeira mensagem a um contacto (ele não lhe escreveu nas últimas 24 horas), ou
- a sessão de 24 horas expirou (nenhuma mensagem do utilizador nas últimas 24 horas).
Dentro da sessão de 24 horas (o utilizador escreveu-lhe nas últimas 24 horas), pode enviar mensagens de sessão—texto livre que não precisa de aprovação de modelo. A Spoki ajuda a gerir modelos e lógica de sessão para enviar sempre o tipo de mensagem correto. Ver registro e suporte.
Por que existem os modelos: a API do WhatsApp Business limita a mensageria não solicitada. Os modelos garantem que as mensagens de saída (quando inicia a conversa ou após 24h) sejam claras e aprovadas. A Spoki guia-o na criação e submissão de modelos para que campanhas, lembretes e fluxos de suporte cumpram as regras.
Quando usar modelos vs. mensagens de sessão
Use um modelo quando:
- envia a primeira mensagem a um contacto (ex. confirmação de reserva, campanha, lembrete);
- contacta de novo após a sessão de 24 horas ter expirado (ex. lembrete de seguimento, nova oferta).
Use mensagens de sessão quando:
- o contacto lhe escreveu nas últimas 24 horas. Pode responder com texto livre, imagens ou botões (dentro dos limites da API). Não precisa de modelo.
A Spoki mantém clara a lógica sessão e modelo: ao tentar enviar, a Spoki usa modelo se necessário e mensagens de sessão quando permitido. Use preços e marcar para planear volume de modelos e sessão.
Como criar e submeter modelos com Spoki
1. Definir a mensagem: Escolha o propósito do modelo (ex. confirmação de reserva, atualização de pedido, lembrete, campanha). Escreva o texto e adicione variáveis ({{1}}, {{2}}) onde precisar de personalização (nome, data, ID de pedido). Mantenha o texto claro e conforme (sem spam, sem conteúdo enganoso). A Spoki e o suporte podem ajudar na redação.
2. Submeter para aprovação: O WhatsApp revê os modelos antes de ficarem ativos. A Spoki guia-o na submissão; a aprovação pode demorar de horas a alguns dias. Use a Spoki para acompanhar o estado e use apenas modelos aprovados. Ver registro e suporte.
3. Enviar com variáveis: Uma vez aprovado, envie o modelo via Spoki passando os valores das variáveis (ex. nome, data, link). A Spoki trata da entrega e das regras de 24 horas. Se o contacto responder, entra na sessão e pode enviar mensagens de sessão. A calculadora ROI ajuda a planear volume de modelos e custo.
Melhores práticas: Use um modelo por caso de uso (ex. um para confirmação de reserva, um para lembrete). Mantenha os modelos curtos e em negrito a informação chave. Inclua opção de opt-out (ex. “Responda STOP para cancelar”) quando aplicável. A Spoki ajuda a gerir opt-in e opt-out para que os modelos fiquem conformes.
Categorias de modelos e exemplos
Utility: Mensagens transacionais (ex. reserva confirmada, estado de pedido). Exemplo: “Olá {{1}}, a sua reserva para {{2}} no dia {{3}} está confirmada. Responda se tiver dúvidas.”
Marketing: Campanhas, ofertas, anúncios. Exemplo: “Olá {{1}}, temos uma oferta para si: {{2}}. Responda STOP para cancelar.”
Authentication: Códigos de uso único ou verificação (se suportado pelo seu fornecedor API). A Spoki e o suporte podem guiá-lo sobre categorias de modelos e aprovação.
Use a Spoki para criar e enviar modelos em cada categoria. Recolha sempre opt-in antes de enviar modelos de marketing; os modelos utility (ex. confirmação de reserva) devem ir apenas a utilizadores que aceitaram mensagens WhatsApp. Ver marcar e preços para a estratégia de modelos.
Erros comuns e como evitá-los
- Enviar texto livre quando é necessário modelo: Se a sessão expirou ou está a enviar a primeira mensagem, deve usar um modelo aprovado. A Spoki ajuda a escolher o modelo correto e bloqueia envios inválidos para manter conformidade.
- Modelos rejeitados: O WhatsApp pode rejeitar modelos pouco claros, promocionais em categoria utility ou que violam políticas. A Spoki e o suporte ajudam a ajustar o texto e reenviar.
- Variáveis erradas: Passe o número e ordem corretos de variáveis ({{1}}, {{2}}, …) ao enviar. A Spoki valida os parâmetros do modelo para que as mensagens partam corretamente.
- Ignorar a janela de 24 horas: Após a última mensagem do utilizador tem 24 horas para enviar mensagens de sessão. Depois use um modelo. A Spoki mantém clara a lógica sessão e modelo para não perder a janela nem violar as regras. Use a calculadora ROI para planear volume de modelos e sessão.
Conclusão
Os modelos da API do WhatsApp Business são obrigatórios para a primeira mensagem e após a sessão de 24 horas. Com a Spoki cria, submete e envia modelos e usa mensagens de sessão quando a conversa está ativa. Opt-in e opt-out ficam na Spoki para mensageria WhatsApp eficaz e conforme.
Pronto para dominar os modelos WhatsApp? Visite a Spoki para a API do WhatsApp Business, registro e preços. Use suporte e marcar para criação de modelos e a calculadora ROI para planear o seu volume de mensageria.

