Automação - Disparo de SMS via Zenvia
Automação - Disparo de SMS via Zenvia
Este documento descreve os passos e campos necessários para configurar o disparo automático de SMS através da integração com a plataforma Zenvia.
Pré-requisitos:
Conta Zenvia ativa com credenciais de acesso.
Créditos de SMS disponíveis na conta Zenvia.
Ter sido liberado a tela de automações no Ambiente
Seção 1: Acesso à Configuração de Automação
1.Selecione a entidade na qual você deseja criar o disparo de SMS.
2.Clique no botão "Automações" ou localize a seção de automações associada a esta entidade.
3.Clique no botão "+ Automação".
4.Na lista de opções de automação, selecione "SMS - Zenvia" para iniciar a configuração do disparo.
Seção 2: Configuração da Ação "Ao Executar" - Disparo de SMS
Dentro da automação, a ação de disparo de SMS é configurada na seção "Ao Executar".
Título da Automação:
No campo "Digite o título da automação", forneça um nome claro e descritivo para a sua automação de disparo de SMS (ex: "SMS de Confirmação de Pedido", "SMS de Alerta de Vencimento").
Certifique-se de que a opção "SMS - Zenvia" esteja selecionada como o tipo de envio.
Aba "CAMPOS" - Dados Essenciais para o Disparo de SMS:
Preencha os seguintes campos com as informações necessárias para o envio do SMS:
Nome do remetente da mensagem:
Descrição: O nome que aparecerá como remetente da mensagem no celular do destinatário.
Formato: Geralmente, pode ser um nome curto da empresa (ex: "SuaEmpresa"), um número de telefone ou um código. Consulte a Zenvia sobre as opções e regras para o nome do remetente (sender ID).
Exemplo: uMov.me
Número do celular do destinatário:
Descrição: O número de telefone para o qual a mensagem será enviada.
Formato: Incluir o código do país e o DDD (ex: +5511987654321 para Brasil, São Paulo). O sistema normalmente esperará um formato numérico.
Observação: Este campo pode ser dinâmico, ou seja, preenchido automaticamente com o número do cliente a partir de dados existentes no sistema, dependendo da configuração da automação.
Texto da mensagem a ser enviada:
Descrição: O conteúdo da mensagem SMS.
Formato: Limite de caracteres para SMS padrão é 160 caracteres. Mensagens maiores serão divididas em várias SMS, podendo gerar custos adicionais. Evite caracteres especiais excessivos que possam não ser interpretados corretamente.
Exemplo: Seu pedido #12345 foi confirmado. Acompanhe a entrega em [link].
Observação: Este campo pode suportar variáveis dinâmicas do sistema (ex: nome do cliente, número do pedido) se tiver sido configurado os dados dentro de campos da entidade (Atividade, tarefa e local)
Data e hora em que a mensagem deve ser enviada:
Descrição: Define o momento exato em que o SMS será disparado.
Formato: Data e hora no formato DD/MM/AAAA HH:MM ou AAAA-MM-DD HH:MM:SS, dependendo do padrão do sistema.
Exemplo: 09/06/2025 10:00
Observação: Para envios imediatos, pode colocar a função de data e hora atual.
Identificador da mensagem no sistema do cliente:
Descrição: Um identificador único para esta mensagem dentro do seu próprio sistema. Isso é útil para rastreamento e auditoria.
Formato: Pode ser um ID numérico, alfanumérico, ou qualquer formato que seu sistema use para identificar transações.
Exemplo: PEDIDO_CONF_SMS_98765
Id de agregador de mensagens por (centro de custo, campanha):
Descrição: Um identificador para agrupar mensagens para fins de custo, relatórios ou categorização de campanha. Útil para empresas com múltiplos centros de custo ou campanhas de marketing.
Formato: Depende da sua estrutura interna de centros de custo ou campanhas.
Exemplo: MARKETING_JUNHO_2025 ou CENTRO_CUSTO_VENDAS
Observação: Esse dado tem que ser configurado diretamente na zenvia e após isso colocado na automação
Aba "CONDIÇÕES":
Descrição: Nesta aba, você pode definir as regras ou condições que, quando atendidas, farão com que o SMS seja disparado.
Exemplo: "Disparar SMS quando o status do pedido for 'Confirmado'".
Configuração: Clique em "Adicionar condição" e selecione os campos e valores que acionarão o disparo.
Aba "AUTENTICAÇÃO":
Descrição: Aqui serão inseridas as credenciais da sua conta Zenvia para que o sistema possa se comunicar com a plataforma de SMS.
Configuração: Aqui será configurado a autenticação da Zenvia para saber qual é a sua conta:
Chave da API (API Key) ou Token: Credencial fornecida pela Zenvia.
Importante: Mantenha estas credenciais seguras e não as compartilhe publicamente.
Seção 3: Salvando a Configuração
Após preencher todos os campos necessários e configurar as condições e autenticação, clique no botão "SALVAR" na parte inferior da tela.
Confirme a gravação das configurações.
Observações Importantes:
Custos: O envio de SMS via Zenvia gera custos. Monitore o saldo de créditos na sua conta Zenvia.
Suporte Zenvia: Em caso de dúvidas sobre as APIs da Zenvia, formato de remetente ou credenciais, consulte a documentação oficial da Zenvia ou entre em contato com o suporte deles.