II. M ANUAL DO UTILIZADOR UMC ONT @ CT
6. ENVIO DE MENSAGENS
No envio de mensagens o utilizador deve ter em atenção a quantidade de crédito disponível, os limites de envio por hora e dia e o template utilizado, sendo o assunto relevante apenas para mensagens de email.
Para mensagens SMS o utilizador deve ter em consideração de que ao utilizar caracteres especiais no corpo da mensagem, poderá ser cobrado o valor superior a um crédito, dependendo do número de caracteres especiais.
O número de caracteres suportados (sem caracteres especiais) é de 160, sendo com caracteres especiais o máximo de caracteres é de 70 por segmento de SMS.
Quando utiliza sistema externos para interligação com a UMContact, sempre que efetuar uma requisição de envio de mensagens, recebe um feedback por parte do sistema. Para mais informações sobre as respostas do serviço veja o tópico Respostas de solicitações de envio.
6.1. Requisitos necessários
Para que seja possível enviar mensagens pela UMCont@ct, um conjunto de requisitos devem sem reunidas:
1º Ser utilizador do sistema; 2º Ter crédito disponível na UMC; 3º Configurar os limites de envio; 4º Ter template disponível;
Ivanir Gomes - Novembro 2014 Pág. 8
6.2. Envio pela conta do cliente
Após as devidas configurações da conta, ao utilizador é disponibilizado um formulário de envio de mensagem individual e outro para envio de mensagem de grupo, aos contactos importados.
Para mensagem individual Selecione o menu Message > MSG Buffer > Create Message Buffer e preenche as informações necessárias e clica em Create.
Na figura 6 é apresentado um exemplo de criação de SMS individual:
Ivanir Gomes - Novembro 2014 Pág. 9
6.2.1. Envio para contactos importados
Mensagem de grupo está disponível apenas para SMS e aos contactos importados. Para envio de mensagens a contactos importados do Excel vá ao menu Message > MSG Buffer > Create msg to imported contacts e preenche as informações necessárias.
Template – template do utilizador a utilizado no processo de envio
Chave – chave que identifica os contactos no sistema, cada chave é um
grupo de contactos.
Built Msg – mensagem a ser enviada ao grupo.
A figura 7 demostra a criação de mensagens de grupo a contactos previamente importados na chave IG_04:
Figura 37 - criação de mensagem de grupo
6.3. Agendamento de mensagens
O processo de agendamento de mensagens dá pela utilização ou não de templates de mensagens com essa funcionalidade. Assim para agendar mensagens o utilizador deve
Ivanir Gomes - Novembro 2014 Pág. 10 primeiramente configurar um template do tipo normal, fornecendo o dia e a hora de envio de mensagens originada a partir do template.
O primeiro dia da semana domingo é representado por 1, sendo segunda 2, terça 3 e assim sucessivamente. A hora deve ser a hora exata do envio, exemplo 1 para 01:00:00, 2 para 02:00:00 e assim por diante. Para intervalo de tempo deve utilizar o (-) para separa os números do intervalo, exemplo 2-4 para segunda a quarta para dia, e 17-20 para 17:00:00 as 20:00:00 para hora.
A seguir figura 8 é apresentado um exemplo de template de agendamento de mensagens para o intervalo de segunda a quinta-feira das 16 as 18 horas:
Ivanir Gomes - Novembro 2014 Pág. 11
6.4. Envio da mensagens por aplicações externas
O foco principal da UMCont@ct é a de enviar alerta diversas de outras aplicações externas, funcionando como um gateway de alertas. Para isso o sistema fornece um Web Service e POST e GET http para uma rápida e segura comunicação entre a sua aplicação e a UMC, desfrutando das diversas vantagens dos nossos serviços de alerta.
6.4.1. Web Service
Para aceder os recursos do nosso sistema os utilizadores do mesmo poderão utilizar o Web Service http://URL_do_site/index.php/service/quote/wsdl:
Ao aceder ao link do Web service o cliente terá acesso ao WSDL (Web Service Description Language) que fornece informações da utilização do Web Service.
Aos utilizadores é fornecido métodos para enviar SMS e Email tanto instantâneo como agendado, consultar crédito no sistema, ver status de uma mensagem no sistema.
6.4.2. POST e GET HTTP
Se preferir o utilizador poderá utilizar o protocolo http como meio de comunicação com a UMC, para isso foi criado e disponibilizado aos clientes um conjunto de métodos que podem ser acedidos tanto por POST como por GET.
A seguir é apresentado um conjunto de GET http que podem ser utilizados também em POST:
Ex1: Envio de mensagens SMS instantâneas:
http://url_do_site_do_sistema/index.php/messageBuffer/ExtAppMsgInstant?User=xxxxx& UserKey=xxxxxx&Template=xx&Destination=xxxxxxx&Msg=xxxxxxxxx
Ivanir Gomes - Novembro 2014 Pág. 12
Ex2: Envio de mensagens SMS agendados:
http://URL_do_site_do_sistema/index.php/messageBuffer/ExtAppMsgNormal?User=xxxx ppMsgNormal?User=xxxxx&UserKey=xxxxxx&Template=xx&Destination=99xxx&Key _names=xxxxxxxx&Key_separator=x&Key_values=xxxxxxx
Ex3: Envio de mensagens Email Instantâneo:
http://URL_do_site_do_sistema/index.php/messageBuffer/ExtAppMsgInstant?User=xxxxx &UserKey=xxxxxx&Template=xx&Destination=xxxxx@xxxx&Msg=xxxxxxxxxxxx&Su bject=xxxxxxxx
Ex3: Envio de mensagens Email Instantâneo:
http://URL_do_site_do_sistema/index.php/messageBuffer/ExtAppMsgNormal?User=xxxx x&UserKey=xxxxxx&Template=xx&Destination=xxxxx@xxxxx&Subject=xxxxxxKey_n ames=xxxxxxxx&Key_separator=x&Key_values=xxxxxxx
Os espaços existentes no corpo da mensagem podem ser substituídos pelo sinal mais (+), no caso de utilização do método GET. Pelos exemplos acima poderá ver que o assunto da mensagens (Subject) é relevante apenas para mensagens de email.