Blog

Trabalhando com a API de SMS para Maker 2.x e Maker 3.x

  1. Adicione os modems na central, usando a função;
    • Para adicionar um modem serial utilize a função “SMS – Central – Adicionar Modem”  informe:
      1. Identificador (Letras)  – Cada rota (modem) deve ter um identificador único;
      2. Porta COM (Letras) EX: COM1, COM10, COM22;
      3. Velocidade (Inteiro) EX 9600, 115200
      4. Número da central de SMS (Letras)
      5. PIN (Letras) Senha do chip;
      6. Fabricante (Letras) HTC, Huawaei, Motorola, …
      7. Modelo (Letras)
  2. Inicie o serviço de SMS. Neste momento é possível associar fluxos para diferentes eventos da central, cada evento tem um conjunto de parametros diferentes;
    • Evento de Mensage:
      1. ID (Letras) identificador da rota;
      2. Tipo: “INBOUND”- Entrada, “OUTBOUND” – Saída, “STATUSREPORT” – Mensagem de status.
      3. Dados (Variante) – Mapa com os dados da mensagem:
        • “Gateway Id” – Identificador da rota
        • “Message Id” – Número sequencial da mensagem (Inteiro)
        • “Message UUID” – Identificador único da mensagem (Letras)
        • “Date” – Data e hora da mensagem (Data).
        • “Encoding” – Codificação do texto (Letras)
        • “Text” – Texto da mensagem (Letras);
        • “Originator” – Origem da mensagem (Letras);
        • “Memory Index” – Posição da mensagem na memória interna do modem (Inteiro);
        • “SMSC Ref No” – Posição da mensagem na memória interna da central (Inteiro);
        • “Recipient” – Destinatário da mensagem (Letras);
        • “Dispatch Date” – Data e hora de envio (Data);
        • “Message Status” – Situação da mensagem (Letras):
          • “UNSENT” – Não enviada;
          • “SENT” – Enviada;
          • “FAILED” – Falhou.
        • “Failure Cause” – Descrição do erro (Letras);
        • “Validity Period” – Horas (Inteiro);
        • “Status Report” – Indica se foi solicitado relatório da situação (Lógico);
        • “Flash SMS” – Indica se foi enviado como “Flash SMS” (Lógico);
    • Retorno:
      • Para apagar a mensagem da memória do modem basta retornar a palavra “DELETE” (Letras) no fim do fluxo de tratamento da mensagem.
  3. Envie quantas mensagens quiser usando a função “SMS – Central – Enviar mensagem”
    1. Destino (Letras) número completo do telefone;
    2. Conteudo (Letras) – Texto da mensagem;
    3. Rota (Letras) identificado da rota de saída (Opcional) – Passe “*” para usar todas;
    4. Expiração (Data) Horário da expiração ou (Inteiro) segundo a partir de agora;
    5. Prioridade (Inteiro) Quanto menor maior 1 = Máxima
    6. Sincorna (Lógico) aguarda o envio;
    7. Monitorar (Lógico) solicitar confirmação de entrega;
  4. Quando não precisar mais enviar SMS, ou for trocar as rotas utilize o comando parar modem.

Leave a comment