izza SMS API - Versão 1.0 Portugal

Transcrição

1 izza SMS API - Versão 1.0 Portugal Nota: Devido às mudanças em curso no sistema de telecomunicações em Portugal e às novas regras de uso dos Números Curtos estabelecidas pela ANACOM, este documento pode vir a sofrer alterações. Vá consultando regularmente a versão mais recente no site.

2 Índice 1. O que é o SMS izza? 2 2. Como funciona? 3 3. Associar Telemóvel a um Utilizador izza 4 4. Consultar Saldo izza 5 5. Carregar Saldo izza 6 6. Inserir Anúncio nos Classificados izza 7 7. Anexo I Países Suportados 10 1

3 1. O que é o SMS izza? O SMS izza é um interface por Mensagens Escritas de Telemóvel (SMS) que permite aos anunciantes registados no site interagir com a Plataforma izza. Algumas das acções permitidas ao anunciante através de SMS incluem: - Consulta do seu saldo na izza - Pedido de dados para pagamento por Multibanco para carregamento de saldo - Inserção de Micro-Anúncios nos Classificados izza Ao associar o seu telemóvel à sua conta de anunciante/utilizador izza no site, passa ainda a poder configurar a izza para: - Acesso ao sistema de Shopping izza, quer para compra, quer para venda de produtos - Programação de avisos automáticos do sistema izza para o seu telemóvel - Etc. Nota: Actualmente, este interface ainda só está disponível em Portugal. 2

4 2. Como funciona? Para poder usar o sistema SMS izza, em primeiro lugar, é necessário que o anunciante esteja registado no site e associe o seu telemóvel à sua conta de utilizador izza. A partir desse momento, o anunciante pode enviar SMS (Mensagens Escritas de Telemóvel) para o nº de SMS da izza em Portugal, o nº 68632, e a izza executará na Plataforma izza a acção solicitada no SMS, podendo ou não devolver um SMS com resposta, dependendo da acção. Por exemplo, um SMS enviado para o nº com o texto IZZA SALDO devolverá um SMS de resposta com o actual saldo em euros para o anunciante associado ao telemóvel de onde a mensagem foi enviada. Nota: Todas as mensagens enviadas para o nº têm um custo de iva. As mensagens recebidas de volta para o telemóvel do anunciante são gratuitas. 3

5 3. Associar Telemóvel a um Utilizador izza Para poder usar o sistema SMS izza, em primeiro lugar, é necessário que o anunciante esteja registado no site e associe o seu telemóvel à sua conta de utilizador izza. Pode fazê-lo de forma simples seguindo os seguintes passos (só precisa fazer isto 1 vez): 1º - Registe-se no site caso ainda não o tenha feito 2º - Faça login no site (visto por enquanto esta funcionalidade apenas estar disponível em Portugal) 3º - Entre na Área Privada de Anunciante > Perfil & Saldo > Perfil 4º - Procure o campo Telemóvel, insira o seu nº de telemóvel e clique em «Validar Telemóvel» 5º - Vai ser-lhe apresentado um código alfanumérico de 11 caracteres, por exemplo, 1AJS64C8B32 6º - A partir do telemóvel que inseriu no seu Perfil, envie um SMS para o nº com o texto IZZA ACTIVAR seguido do código que lhe foi apresentado quando clicou em «Validar Telemóvel», deixando sempre um espaço entre as palavras. Neste exemplo, seria: IZZA ACTIVAR 1AJS64C8B32 7º - No prazo máximo de 1 minuto, receberá de volta um SMS com um código de confirmação, também ele um código alfanumérico de 11 caracteres, por exemplo, 2C47V4AU9PW 8º - Insira o código de confirmação na secção de «Validar Telemóvel» do seu Perfil, onde diz: «Inserir Código de Confirmação» 9º - E já está. A partir daí, sempre que enviar um SMS para a izza a partir desse telemóvel, as suas acções estarão associadas ao utilizador izza onde realizou esta validação. Nota: Ao validar o seu telemóvel na izza não está a subscrever qualquer serviço de comunicações. A única despesa que tem com o sistema SMS izza é o custo das mensagens que decidir enviar para a izza. Todas as mensagens que receber de volta serão gratuitas. Esclarecemos ainda que a izza não fornece o seu nº de telemóvel a terceiros, nem lhe enviará qualquer mensagem comercial. 4

6 4. Consultar Saldo izza Para poder usar alguns serviços izza, como por exemplo a realização de Campanhas Publicitárias Online Multimédia, é necessário que o anunciante possua um Saldo/Crédito superior a 0,00 para que as campanhas sejam veiculadas, visto que o saldo vai sendo utilizado à medida que a campanha decorre e ao atingir 0,00 a campanha é interrompida. Para evitar tal interrupção, é importante que o anunciante vá consultando regularmente o saldo que tem na izza para que o possa reforçar caso seja necessário. Contudo, nem sempre é possível ao anunciante ter acesso à Internet para poder ir ao site izza consultar o saldo. Nessas situações, a izza disponibiliza a possibilidade do anunciante consultar o seu saldo via SMS. Se já tiver associado o seu telemóvel à sua conta de anunciante izza, basta enviar um SMS para o nº com o texto IZZA SALDO e em resposta receberá a indicação do seu actual saldo em euros na izza. Se for necessário reforçar o seu saldo, e não tem acesso à internet no momento, consulte a secção seguinte deste documento para saber como pode solicitar à izza, por SMS, dados de carregamento no Multibanco. 5

7 5. Carregar Saldo izza Se tiver campanhas a decorrer na izza e se tiver consultado o seu saldo na izza, pode verificar que é necessário reforçar esse saldo para que as campanhas não sejam interrompidas. A izza recomenda que sempre que verificar que o seu saldo é inferior a 10,00 o reforce pelo menos com mais 10,00. Isto porque, em certas campanhas, o seu anúncio pode ser apresentado a muitos consumidores num curto espaço de tempo, o que poderá levar ao esgotamento do saldo e consequente interrupção da campanha. Se tiver um saldo maior, minimiza esse risco e nunca desperdiça esse dinheiro pois se não o gastar nessa campanha pode sempre usá-lo noutras campanhas ou serviços izza. Se estiver fora da internet e decidir reforçar o seu saldo izza, pode usar o sistema de SMS izza para solicitar uma referência Multibanco que lhe permita, através de uma Caixa Multibanco ou do Telemultibanco no seu telemóvel, carregar o seu saldo izza. Se já tiver associado o seu telemóvel à sua conta de anunciante izza, basta enviar um SMS para o nº com o texto IZZA MB seguido do valor que pretende carregar, deixando sempre um espaço entre as palavras, por exemplo, IZZA MB 25 o que neste exemplo significa que pretenderia carregar 25 euros na izza, através do Multibanco. Em resposta, receberá um SMS com indicação da Entidade e Referência Multibanco a utilizar. Depois é só realizar o pagamento escolhendo a opção «Pagamento de Serviços» no Multibanco com os dados que recebeu da izza. Nota 1: Carregue sempre valores inteiros e nunca com cêntimos (por exemplo, pode carregar 25 mas não 25,50). Nota 2: Salvo problemas técnicos, o seu saldo será actualizado no prazo de alguns minutos após o pagamento no Multibanco, não ultrapassando nunca o prazo máximo de 24h. Se tal não acontecer, contacte a izza. Nota 3: Cada conjunto de dados de pagamento só pode ser usado 1 vez e tem uma validade de 1 semana. Isso significa que se realizar um pagamento ou se deixar passar 1 semana sem o realizar, para fazer novo pagamento, mesmo que seja o mesmo valor, é obrigatório solicitar novos dados pois aqueles já não serão válidos e se os utilizar o seu saldo izza não irá reflectir esse pagamento. 6

8 6. Inserir Anúncio nos Classificados izza Os Anúncios Classificados izza são anúncios de texto, organizados por Países, Cidades/Regiões e Tipos de Serviço/Áreas de Actividade. Ao contrário dos Anúncios Classificados tradicionais, presentes num único meio de comunicação ou site de Internet, os Anúncios Classificados izza encontram-se disseminados por centenas de Sites Parceiros, disponíveis através do izza FlexiWidget o que permite à sua empresa chegar de forma natural e imediata a um público bastante vasto. O seu anúncio nos Classificados izza pode ser colocado através da Plataforma Web da izza, ou por SMS. Colocado pela Web, cada anúncio tem mais opções, espaço para texto e contactos do que se for colocado por SMS. Como tal, a colocação dos anúncios izza por SMS não deve ser encarada como uma substituição da Plataforma Web mas sim um complemento que pode ser útil em situações, por exemplo, de ausência de acesso à Internet, ou ausência de saldo na izza. Para colocar um anúncio classificado izza por SMS, na sua forma mais simples, se já tiver associado o seu telemóvel à sua conta de anunciante izza, basta enviar um SMS para o nº com as palavras IZZA AD seguidas do texto do anúncio, deixando sempre um espaço entre as palavras, por exemplo, IZZA AD VENDO COMPUTADOR APPLE 1000 EUROS Por defeito, o seu anúncio irá ser colocado de acordo com o Perfil que definir para os anúncios por SMS, disponível na Área Privada de Anunciante > Anunciar/Vender > Inserir um Anúncio Classificado izza > SMS > Perfil Assim, aspectos como o País, a Cidade/Região, o contacto a divulgar (telemóvel ou , ou ambos), ou o link para onde quer redireccionar o clique no anúncio, poderão estar prédefinidos, não tendo que os escrever no SMS. Contudo, pode sempre enviar no SMS parâmetros que substituem os valores por defeito. Por exemplo, ao enviar IZZA AD E marketers@izza.org VENDO COMPUTADOR APPLE 1000 EUROS o mesmo anúncio será publicado apenas com o indicado, independentemente do seu Perfil ter ou não pré-definido outro ou mesmo um telemóvel. 7

9 Segue-se uma tabela com todas as palavras-chave que pode enviar por SMS juntamente com o seu anúncio classificado, bem como exemplos de uso. Palavra-chave Parâmetro Exemplo Nenhum IZZA AD VENDO PC Neste exemplo, nenhuma palavra-chave foi inserida; como tal, o anúncio será incluído no país/região configurado no perfil do anunciante e serão apresentados o e telefone que estiverem configurados no perfil; pelo conteúdo do anúncio, o sistema tentará incluir o anúncio na actividade mais adequada, caso contrário será publicado em «Vários» T Telefone de contacto IZZA AD T VENDO PC Neste exemplo, apenas o telefone indicado será publicado como contacto com o anúncio; nenhum telefone ou configurado como pré-definido será apresentado E de contacto IZZA AD E marketers@izza.org VENDO PC Neste exemplo, apenas o indicado será publicado como contacto com o anúncio; nenhum telefone ou configurado como pré-definido será apresentado T E Telefone e de contacto IZZA AD T E marketers@izza.org VENDO PC Neste exemplo, o telefone e o indicados serão ambos publicados com o anúncio; nenhum telefone ou configurado como pré-definido será apresentado P País (identificado pela sigla internacional do país) IZZA AD P PT VENDO PC Neste exemplo, o anúncio será publicado para o país indicado; em caso de ausência, será usado o país prédefinido no perfil do anunciante L Localidade IZZA AD L LISBOA VENDO PC Neste exemplo, o anúncio será publicado na cidade/região indicada; em caso de ausência, será usada a localidade prédefinida no perfil do anunciante C Categoria / Tipo de Produto / Serviço IZZA AD C INFORMATICA VENDO PC Neste exemplo, o anúncio será publicado na categoria indicada; em caso de ausência, o sistema tentará adequar o anúncio à categoria correcta, a partir da interpretação do seu conteúdo, senão será publicado em «Vários» Um exemplo completo poderia ser (dentro dos 160 caracteres máximos): IZZA AD P PT L LISBOA C INFORMATICA T E marketers@izza.org Vendo Computador MacBook c/3 anos Excelente Estado 500 EUR Aceito troca por iphone 3G 8

10 Após o envio do anúncio por SMS, a izza permite-lhe ainda, opcionalmente, associar um URL/link de Internet ao seu anúncio. Assim, para além dos contactos que possa ter publicado, sempre que alguém clicar no seu anúncio será redireccionado para o link que indicar, o qual pode ser uma página de detalhe do produto, a sua loja online, o seu blog, etc. Para tal basta que, após ter enviado o anúncio com um texto do tipo IZZA AD, como descrito na página anterior, envie um novo SMS para o mesmo nº com o texto IZZA LINK seguido do link que pretende publicar, por exemplo: IZZA LINK A izza irá recepcionar este SMS e irá associar o link ao último anúncio que tenha recebido da sua parte por SMS. Note que se pretender colocar vários anúncios seguidos por SMS, deverá enviar sempre o SMS com o link logo após o SMS do respectivo anúncio, caso contrário o sistema da izza não saberá a que anúncio você pretende associar aquele link. Resumindo, com o IZZA AD envia o anúncio e logo de seguida com o IZZA LINK envia o respectivo link. Após o envio do seu anúncio com o sistema SMS izza, este ficará publicado nos Classificados izza, disponíveis através do FlexiWidget em centenas de sites parceiros, durante um período de 1 ano. Passará igualmente a ficar disponível na sua área de Gestão de Campanhas e Anúncios no site onde não o poderá editar mas poderá eliminar uma vez que deixe de fazer sentido, por exemplo, por ter já vendido o produto anunciado. Nota 1: Comece sempre o texto do anúncio propriamente dito com uma das palavras VENDO, PROCURO, COMPRO, ALUGO, TROCO para que não hajam dúvidas em relação à sua intenção com o que deseja do anúncio. Nota 2: A totalidade dos caracteres do SMS não pode ultrapassar os 160. O sistema de SMS izza não suporta SMS longos/múltiplos com mais de 160 caracteres. Nota 3: Ao enviar um SMS do tipo IZZA AD ou IZZA LINK não receberá de volta nenhum SMS da izza. Poderá confirmar que a izza recepcionou o anúncio pois o mesmo, no prazo de minutos, passará a estar disponível quer na sua área de gestão de anúncios do site quer na área de Anúncios Classificados no FlexiWidget dos sites parceiros. Nota 4: Apenas links iniciados por e são permitidos. 9

11 7. Anexo I Países Suportados nos Anúncios Classificados Esta é a lista dos países (e respectivas siglas) suportados pela izza para publicação dos anúncios classificados, apesar dos SMS izza ainda só serem suportados em Portugal. AF ZA AL DE AD AO AG SA DZ AR AM AU AT AZ BS BD BB BH BE BZ BJ BY BO BA BW BR BN BG BF BI BT CV CM KH CA KZ TD CL CN CY CO KM KP KR CI CR HR CU DK DJ DM EG SV AE EC ER SK SI ES US EE ET FJ PH FI FR Afeganistão África do Sul Albânia Alemanha Andorra Angola Antígua e Barbuda Arábia Saudita Argélia Argentina Arménia Austrália Áustria Azerbeijão Bahamas Bangladesh Barbados Barém Bélgica Belize Benin Bielorrússia Bolívia Bósnia e Herzegovina Botswana Brasil Brunei Darussalam Bulgária Burkina Faso Burundi Butão Cabo Verde Camarões Camboja Canadá Cazaquistão Chade Chile China Chipre Colômbia Comores Coreia do Norte Coreia do Sul Costa do Marfim Costa Rica Croácia Cuba Dinamarca Djibuti Dominica Egipto El Salvador Emirados Árabes Unidos Equador Eritreia Eslováquia Eslovénia Espanha Estados Unidos da América Estónia Etiópia Fiji Filipinas Finlândia França GA GM GH GE GD GR GT GY GN GQ GW HT NL HN HU YE FO MH SB IN ID IR IQ IE IS IL IT JM JP JO KG KI KW LA LS LV LB LR LY LI LT LU MK MG MY MW MV ML MT MA MU MR MX FM MZ MD MC MN ME MM NA NR NP NI NE NG Gabão Gâmbia Gana Geórgia Granada Grécia Guatemala Guiana Guiné Guiné Equatorial Guiné-Bissau Haiti Holanda Honduras Hungria Iémen Ilhas Faroé Ilhas Marshall Ilhas Salomão Índia Indonésia Irão Iraque Irlanda Islândia Israel Itália Jamaica Japão Jordânia Kirguizistão Kiribati Kuwait Laos Lesoto Letónia Líbano Libéria Líbia Liechtenstein Lituânia Luxemburgo Macedónia Madagáscar Malásia Malawi Maldivas Mali Malta Marrocos Maurícias Mauritânia México Micronésia Moçambique Moldávia Mónaco Mongólia Montenegro Myanmar Namíbia Nauru Nepal Nicarágua Níger Nigéria NO NZ OM PW PA PG PK PY PE PL PR PT QA KE UK CF CZ CD CG DO RO RW RU EH WS LC KN SM ST VC SN SL RS SC SG SY SO LK SZ SD SE CH SR TJ TH TW TZ TP TG TO TT TN TM TR TV UA UG UY UZ VU VA VE VN ZM ZW Noruega Nova Zelândia Omã Palau Panamá Papua Nova Guiné Paquistão Paraguai Peru Polónia Porto Rico Portugal Qatar Quénia Reino Unido República Centro-Africana República Checa República Democrática do Congo República do Congo República Dominicana Roménia Ruanda Rússia Sahara Ocidental Samoa Santa Lúcia São Cristóvão e Neves São Marino São Tomé e Príncipe São Vicente e Grenadinas Senegal Serra Leoa Sérvia Seychelles Singapura Síria Somália Sri Lanka Suazilândia Sudão Suécia Suíça Suriname Tadjiquistão Tailândia Taiwan Tanzânia Timor Leste Togo Tonga Trinidade e Tobago Tunísia Turkmenistão Turquia Tuvalu Ucrânia Uganda Uruguai Uzbekistão Vanuatu Vaticano Venezuela Vietname Zâmbia Zimbabué 10