Uma confirmação de pedido pode reutilizar seu texto enquanto altera o número do pedido para cada destinatário. Isso mantém o fluxo consistente enquanto os dados mudam.
O que um template contém?
Um template contém texto fixo, definições de variáveis e a categoria da mensagem, que classifica por que você está enviando a mensagem. Um destino pode aplicar essa classificação de conteúdo às suas regras de registro.
Cada variável nomeia um valor que muda entre envios, como um número de pedido. O template define o tipo aceito, se é obrigatório e qualquer restrição sobre seu valor.
O conteúdo e os modelos de campanha combinam texto reutilizável com valores específicos do destinatário. O catálogo de modelos da Bird inclui modelos do sistema para mensagens de autenticação e transacionais. Os modelos do espaço de trabalho permitem publicar seu próprio texto em vários idiomas. A criação ocorre pela API de gerenciamento de modelos.
Leia as variáveis antes de escolher um template. Uma prévia com aparência familiar não garante que seus valores obrigatórios correspondam aos dados que sua aplicação possui.
Templates SMS precisam de aprovação?
Os modelos integrados estão prontos para envio. Publicar um modelo do espaço de trabalho valida seu texto e suas variáveis. A versão publicada fica disponível imediatamente, sem aprovação da Meta. As regras do destino ainda podem exigir registro de conteúdo.
São processos separados. O corpo de mensagem reutilizável de um provedor não garante, por si só, conformidade com as regras de um destino.
Por exemplo, as orientações da TRAI para remetentes exigem registro de templates de conteúdo para comunicações por meio de identidades de remetente registradas na Índia. Esse requisito diz respeito à estrutura da mensagem, incluindo partes fixas e variáveis.
Verifique o destino antes de escolher o fluxo de envio. O registro de remetente diz respeito à identidade de envio e pode coexistir com um requisito de conteúdo.
Como Bird escolhe a categoria e o remetente?
O modelo fornece a categoria, que classifica o conteúdo conforme o motivo do envio. Os modelos integrados selecionam um remetente para o destino; os modelos do espaço de trabalho usam o remetente que você informa.
Um envio com modelo rejeita text, category e media_urls junto com template. Omita from para um modelo integrado e informe-o para um modelo do espaço de trabalho. O contrato de envio com modelo documenta esses requisitos.
Use um modelo do espaço de trabalho ou texto livre quando sua aplicação precisar escolher um remetente específico.
Inspecione from e category na resposta. Esses campos informam qual remetente e classificação de conteúdo Bird selecionou para aquela mensagem.
Como envio um template em Bird?
Identifique um modelo publicado e forneça os valores de suas variáveis no objeto template do envio.
Use slug ou id para identificá-lo. Consulte GET /v1/sms/templates/{template_ref} para obter sua live_version_id e depois GET /v1/sms/templates/{template_ref}/versions/{version_id} para o conteúdo e as definições de variáveis.
Coloque os valores em parameters, indexados pelo nome da variável. Valores obrigatórios ausentes, chaves não declaradas ou formatos inválidos retornam 422, então valide os valores antes de liberar o envio.
O objeto de parâmetros serializado deve caber em 16 KB. Bird rejeita uma solicitação que exceda esse limite, então restrinja-se aos valores declarados do template.
Escolha language quando necessário. As configurações de idioma do template determinam o padrão e qualquer fallback, então inspecione essas configurações em vez de assumir que todo idioma solicitado existe.
Templates mudam como SMS é cobrado?
O texto renderizado é contado como qualquer outro corpo SMS.
Insira os valores reais antes de estimar os segmentos. Uma referência de pedido longa ou um nome fora do alfabeto compacto pode aumentar a contagem.
Uma referência de template não é um preço fixo para cada destinatário. O segments.count da resposta informa as partes cobráveis daquela mensagem renderizada.
Quando devo escolher um template?
Escolha um template do catálogo quando seu corpo, variáveis e comportamento de seleção de remetente se encaixarem no seu fluxo.
- Use um template quando o corpo fornecido corresponder à mensagem e você tiver os valores obrigatórios.
- Publique um modelo do espaço de trabalho para reutilizar texto com seu próprio remetente ou use texto livre para uma mensagem individual.
- Aplique os requisitos de registro do destino a qualquer uma das escolhas.
Em resumo
Os modelos contêm texto reutilizável e definições de variáveis.
Escolha um modelo integrado ou um modelo publicado do espaço de trabalho e forneça os valores obrigatórios.
A seleção do remetente depende do escopo do modelo.
Os modelos integrados usam um remetente selecionado pela Bird. Os modelos do espaço de trabalho exigem um remetente que pertença a você. O modelo fornece a categoria.
A publicação no espaço de trabalho não exige análise da Meta.
Publicar um modelo do espaço de trabalho valida seu rascunho. A versão publicada fica imediatamente disponível para envio. As regras de registro de conteúdo do destino continuam separadas.
Valores substituídos ainda afetam a contagem de segmentos.
Verifique a mensagem renderizada porque valores mais longos podem aumentar os segmentos cobrados.