Uma atualização de pedido precisa de texto fixo e detalhes específicos da compra. Um template mantém o texto aprovado separado de valores como o número do pedido.
Quando preciso de um template?
Use um template aprovado ao enviar fora da janela de serviço de 24 horas do cliente.
Dentro de uma janela aberta, você pode responder com conteúdo livre. Enviar um template não reabre essa janela por si só; a resposta do cliente é que reabre.
A aprovação não substitui a permissão do cliente. Siga a política de mensagens da Meta para a mensagem que você pretende enviar.
O que um template contém no Bird?
Um template identifica conteúdo reutilizável, enquanto suas versões guardam o texto de cada idioma.
Use o slug ao enviar. O nome de exibição rotula o template, mas não é o identificador usado para resolver um envio.
Escolha authentication, marketing ou utility ao criar o template. Bird mantém a categoria declarada e o slug fixos após a criação.
O conteúdo de um idioma inclui um bloco body obrigatório. Ele também pode incluir header, footer, buttons ou carousel, conforme as regras de conteúdo do template.
Para inspecionar o conteúdo aprovado, leia live_version_id do template. Em seguida, recupere o idioma dessa versão por meio do comando de idioma.
Um template sem versão ativa não pode enviar. Seu rascunho ainda pode conter conteúdo que não passou pela revisão.
Qual idioma e categoria um envio vai usar?
Verifique available_languages para idiomas disponíveis para envio. Verifique o category do próprio idioma para a classificação de cobrança da Meta.
O status do template resume seus idiomas. Um template active tem pelo menos um idioma disponível para envio. Outro idioma pode estar rejeitado, pausado ou desabilitado.
A Meta pode remover a aprovação ou a disponibilidade de um idioma após o lançamento. Verifique o estado do idioma ao enviar em vez de manter uma lista fixa desde a implantação.
A Meta também pode reclassificar um idioma sem alterar a categoria que você declarou. Use a classificação desse idioma com as tarifas publicadas do WhatsApp ao estimar custos.
Use exemplos para verificar a categoria antes de submeter um idioma:
| Conteúdo de exemplo | Lição sobre a categoria pretendida |
|---|---|
Your order {{reference}} has shipped. | Uma atualização específica de transação segue o padrão utility |
Your code is {{code}}. | Uma mensagem de autenticação usa a categoria authentication e suas regras de criação |
Get 20% off your next order. | Uma oferta promocional pertence ao caminho marketing |
Mantenha os exemplos ilustrativos. A Meta analisa o idioma submetido e pode classificá-lo de forma diferente da categoria que você selecionou.
Defina on_missing_language para decidir o que acontece quando o idioma solicitado não tem cópia disponível. Bird define fail como padrão para novos templates WhatsApp. Cada idioma é aprovado e cobrado separadamente, então um substituto silencioso pode enviar conteúdo inesperado a uma tarifa não pretendida.
Essa política ainda permite uma tag mais ampla: pt pode atender a uma solicitação para pt-BR. Ela não substitui a variante irmã pt-PT.
Escolha fallback somente quando substituir pelo idioma padrão configurado for aceitável para seus destinatários. Templates gerenciados por Bird mantêm sua política fixa de idioma ausente.
Como altero conteúdo submetido?
Crie um novo rascunho. Escreva o idioma corrigido. Submeta essa versão para revisão.
Bird mantém versões submetidas imutáveis, então editar o rótulo do template não altera o conteúdo de mensagem aprovado.
| Campo | O que ele indica |
|---|---|
draft_version_id | Existe um rascunho não submetido |
pending_version_id | Uma versão submetida ainda tem idiomas não resolvidos |
live_version_id | Esta versão fornece o conteúdo usado para envios |
A aprovação de um idioma pode tornar toda a sua versão ativa. Outros idiomas nessa versão ainda podem estar pendentes ou rejeitados.
Verifique o idioma da versão submetida para acompanhar uma revisão. O template pode ainda mostrar uma versão ativa anterior enquanto a substituição aguarda aprovação.
Como envio um template?
Nomeie o template. Forneça as variáveis exigidas pelo idioma que você pretende enviar.
Encontre os templates disponíveis com:
bird whatsapp templates listUse bird whatsapp templates get para inspecionar o template selecionado. Recupere o conteúdo do idioma antes de montar os components do envio, que carregam os valores para as variáveis desse template.
No dashboard, o detalhe do template fornece um exemplo cURL com os valores de exemplo desse template. Substitua o destinatário, as credenciais e as variáveis pelos valores pretendidos antes de enviar.
Um template criado precisa de um remetente na mesma WhatsApp Business Account. Siga o procedimento de envio. Rastreie o identificador de mensagem retornado por meio de eventos de entrega.
Uma resposta 202 aceita a solicitação para processamento. Confirme a entrega pelo resultado posterior antes de tratar a mensagem como recebida.
Em resumo
Verifique o idioma antes de enviar.
Um template ativo pode conter idiomas indisponíveis. Use
available_languagespara verificar se o idioma do destinatário pode enviar.Leia a categoria do idioma.
A Meta pode classificar um idioma de forma diferente da categoria que você declarou. A cobrança segue a classificação da Meta.
Edite por meio de um novo rascunho.
Bird congela versões submetidas. Crie um novo rascunho para alterar o conteúdo. Submeta o idioma corrigido para revisão.
Envie o conteúdo aprovado com suas variáveis.
Nomeie o template e forneça os valores que o idioma espera. Uma solicitação aceita não confirma a entrega.