Pular para o conteúdo
AnnA Docs

Enviando notificações ativas

Esse serviço executa templates de notificação e envia para os usuários via WhatsApp

Variáveis POST

  • HASH: Hash da empresa que o template está cadastrado
  • ANNAEXEC: O IV que foi gerado, esse deve ser utilizado para encriptação dos valores de outras variáveis
  • Name: Nome do template que será enviado
  • Namespace: Namespace do template que será enviado
  • TemplateData: Contém a lista de telefones e macros/variáveis para o template que será enviado
    • DeliveryDate: (Opcional) Utilize essa propriedade para agendar o envio. O formato deve ser preenchido como YYYYMMDDHHMM
    • Reference: (Opcional) Utilize esse campo para fazer anotações sobre o envio
    • PhoneList: Lista de telefones separados por ponto e vírgula, por exemplo, “551199999999;551388888888”
    • Prop_Keys: Contém a lista de macros que serão substituídas e seus valores
      • PropName: ID da macro. Pode ser utilizada como {{0}}, {{1}}, {{2}},…
        NOTA: O slot {{0}} é reservado para arquivos de mídia e o valor deve ser um URL
      • PropValue: Valor que irá substituir a macro
    • Prop_Parms: Contém a lista de parâmetros que serão adicionados a execução
      • PropName: Nome do parâmetro
      • PropValue: Valor do parâmetro
  • ReturnMode: (Opcional) Define o tipo de retorno. Se não informado, então o valor DEFAULT será considerado
    • DEFAULT: Retorno uma lista de telefones com seus respectivos estados de envio
    • RESUME: Retorna um JSON com dados do envio
      • RequestStatus: Estado do envio
        • CANCELED: Todas as notificações foram canceladas
        • QUEUED: Em fila para enviar
        • PROCESSED: Todas as notificações foram enviadas
        • PROCESSING: O sistema está enviado as notificações

Exemplos

Alguns exemplo de como implementar o envio de notificações AnnA:

  public static string Execute_WebService()
  {
    string DecKey = "DECRYPTION_KEY";
    string EncKey = "ENCRYPTION_KEY";
    string Hash = "COMPANY_HASH";
    // Generate new IV
    TripleDESCryptoServiceProvider auxTdes = new TripleDESCryptoServiceProvider();
    auxTdes.GenerateIV();
    byte[] IVArray = auxTdes.IV;
    string IV = Convert.ToBase64String(IVArray);


    string templateName = "TEMPLATE_NAME";
    string encryptedTemplateName = Encrypt(templateName, EncKey, IV);
    string templateNamespace = "TEMPLATE_NAMESPACE";
    string encryptedTemplateNamespace = Encrypt(templateNamespace, EncKey, IV);


    string json = "[{";
    json += "\"PhoneList\":\"950691561;914694745\",";
    json += "\"Prop_Keys\":";
    json += "   [";
    json += "       {";
    json += "           \"PropName\":\"{{1}}\",";
    json += "           \"PropValue\":\"AnnA\"";
    json += "       },";
    json += "       {";
    json += "           \"PropName\":\"{{2}}\",";
    json += "           \"PropValue\":\"10/07/2021\"";
    json += "       }";
    json += "   ],";
    json += "\"Prop_Parms\":";
    json += "   [";
    json += "       {";
    json += "           \"PropName\":\"var\",";
    json += "           \"PropValue\":\"AnnA\"";
    json += "       }";
    json += "   ]},";
    json += "   {";
    json += "\"PhoneList\":\"977225248;971195982\",";
    json += "\"Prop_Keys\":";
    json += "   [";
    json += "       {";
    json += "           \"PropName\":\"{{2}}\",";
    json += "           \"PropValue\":\"10/08/2021\"";
    json += "       }";
    json += "   ],";
    json += "\"Prop_Parms\":";
    json += "   [";
    json += "       {";
    json += "           \"PropName\":\"var\",";
    json += "           \"PropValue\":\"AnnA\"";
    json += "       }";
    json += "   ]";
    json += "}]";


    string encryptedTemplateData = Encrypt(json, EncKey, IV);


    string postData = "HASH=" + Uri.EscapeDataString(Hash);
    postData += "&ANNAEXEC=" + Uri.EscapeDataString(IV);
    postData += "&Name=" + Uri.EscapeDataString(encryptedTemplateName);
    postData += "&Namespace=" + Uri.EscapeDataString(encryptedTemplateNamespace);
    postData += "&TemplateData=" + Uri.EscapeDataString(encryptedTemplateData);
    byte[] data = Encoding.UTF8.GetBytes(postData);


    string url = "https://YOUR_ANNA_URL/aannatemplatenotification.aspx";
    WebRequest requisicaoWeb = WebRequest.Create(url);
    requisicaoWeb.Method = "POST";
    requisicaoWeb.ContentType = "application/x-www-form-urlencoded";
    requisicaoWeb.ContentLength = data.Length;


    Stream dataStream = requisicaoWeb.GetRequestStream();


    dataStream.Write(data, 0, data.Length);
    dataStream.Close();


    WebResponse response = requisicaoWeb.GetResponse();


    using (dataStream = response.GetResponseStream())
    {
        StreamReader reader = new StreamReader(dataStream);
        string responseFromServer = reader.ReadToEnd();


        if (responseFromServer.Contains(IV))
        {
            string newEncryptedIv = responseFromServer.Substring(responseFromServer.IndexOf(IV));
            newEncryptedIv = newEncryptedIv.Replace(IV, "");
            string encryptedResponse = responseFromServer.Substring(0, responseFromServer.IndexOf(IV));


            string newIv = Decrypt(newEncryptedIv, EncKey, IV);


            string responseData = Decrypt(encryptedResponse, DecKey, newIv);


            response.Close();


            return responseData;
        }
        else
        {
            response.Close();
            return responseFromServer;
        }
    }
  }