Introdução

Salesforce é uma plataforma que gere relacionamentos com clientes, um dos CRMs mais poderosos do mercado, se você usa esta ferramenta e deseja se comunicar com seus contactos, temos a melhor combinação para você.

A integração do 360nrs com o Salesforce permite que você envie e receba SMS facilmente do Salesforce usando os melhores recursos dele.

Considerações preliminares

Para que a integração funcione corretamente, é necessário ter em conta as seguintes considerações anteriores:

É necessário ter uma conta 360NRS e saldo suficiente.
Os números de móveis devem incluir sempre o prefixo internacional. Caso contrário, não podem ser entregues corretamente.
Os remetentes podem ser numéricos ou alfanuméricos. Para remetentes numéricos, a extensão máxima é de 15 caracteres e para alfanuméricos de 11 caracteres.
Um SMS padrão tem no máximo 160 caracteres usando a codificação GSM7. Os caracteres que não estão incluídos na codificação GSM7 serão automaticamente substituídos pelo caractere de GSM7 mais semelhante. Por exemplo: á não está incluso no GSM7, por tanto é substituido por a, que está incluso. Pode encontrar todos os caracteres GSM7 permitidos no anexo.
Alguns caracteres incluídos no GSM7 contam como 2 caracteres. Pode encontrar os caracteres duplos no anexo.
Se o tamanho do SMS for maior do que o máximo permitido, o sistema concatenará o SMS necessário até um máximo de 5 SMS. (o usuário final recebe um único SMS).
Os SMS certificados têm um custo adicional.

Credenciais

Para integrar 360NRS com Salesforce Marketing Cloud, é necessário fazer a conexão entre 360NRS e Salesforce Marketing Cloud.

Para fazê-lo, vá para sua conta de Salesforce Marketing Cloud no menu 360NRS SMS dentro de AppExchange

Ilustração 1 - AppExchange

Vai aparecer a seguinte tela:

Ilustração 2 - Conexão

Ao pressionar o botão CONNECT será redirecionado para a tela de login, onde deve inserir os dados da sua conta 360NRS.

Ilustração 3 - Credenciais

Depois de inserir as credenciais, será redirecionado para a visualização inicial, onde, se tudo correr bem, poderá encontrar o botão de desconexão.

Ilustração 4 - Conectado

Journey Builder

Em qualquer momento, poderá adicionar uma ação de envio de SMS por meio do 360NRS.

Para fazê-lo, deve clicar no botão Enviar SMS que aparece na seção Activities.

Ilustração 5 - Enviar SMS

Para adicionar a atividade ao Journey, deve arrastar e soltar onde quiser, mas antes deve configurar uma Entry Source; caso contrario não será possível configurar a sua mensagem.

Ilustração 6 - Entry source

Depois de clicar em Enviar SMS, aparecerá um menu pop-up onde pode inserir os detalhes da sua mensagem.

Ilustração 7 - Campos obrigatórios

Ilustração 8 - Campos opcionais

Aqui pode inserir os seguintes dados:

Campo	Descrição
Remetente	Texto do remetente, este parâmetro pode conter até 15 dígitos ou 11 caracteres alfanuméricos.
Codificação	Os valores possíveis são gsm e utf-16. O valor `gsm` para envios standard com codificação GSM7 e 160 caracteres por mensagem, e o valor `utf-16` para codificação UCS2 (UTF16) e 70 caracteres por mensagem. Se não for especificado, o valor padrão é `gsm`.
Mensagem	Texto da mensagem. Neste campo pode adicionar variáveis personalizadas a partir da fonte de entrada selecionada; estas variáveis são substituídas pelos valores correspondentes da fonte de entrada. Também pode adicionar emoticons, disponíveis somente em codificação UTF-16.
URLs	URLs personalizadas, para obter mais informações, consulte seção URLs.
Expiração	Data a partir da qual a mensagem não é enviada.
Certificado Sms	Se este parâmetro for especificado como `true`, a mensagem será enviada como SMS certificado. `* As mensagens certificadas têm custo adicional.`
Nome da campanha	Se especificado, as estatísticas serão agrupadas com esse nome. Se não especificado, as estatísticas serão agrupadas automaticamente por mês.
Tags	Adicione TAGs e eles serão exibidos na coluna `TAGs` das estatísticas.
ID externo	Selecione uma coluna na `Data extensio` e essas informações serão exibidas na coluna `ID externo` das estatísticas.

Quando sua mensagem estiver pronta, pressione o botão Concluído na parte inferior e a ação Enviar SMS será integrada ao Journey; nesse momento a caixa de atividade estará em verde.

Ilustração 9 - Executar Journey

O SMS será enviado assim que o SMS for executado e essa ação for atingida.

Campanha de SMS

Nesta seção, você poderá enviar ou agendar uma campanha por SMS usando os dados de entrada de um Data Extension.

O assistente possui quatro etapas: na primeira, a fonte de dados é selecionada, na segunda, o SMS é configurado, na terceira, os parâmetros opcionais são configurados e na quarta, uma pré-visualização é exibida.

1. Seleccione a fonte de dados

Nesta etapa, insira o External Key do Data Extension que contém os dados para o lançamento da campanha.

Ilustração 10 - Fonte dos dados

Aqui pode inserir:

Campo	Descrição
External Key	É o ID exclusivo do seu Data Extension.

Depois de inserir o External Key do Data Extension, deverá pressionar o botão VERIFICAR. Se tudo estiver correto, será exibida uma pré-visualização de 3 elementos, mostrando as informações obtidas a partir do Data Extension.

Ilustração 11 - Data extension pre-visualização

A continuação, deve selecionar o país para o qual deseja enviar, a coluna do Data Extension que contém o telefone e, opcionalmente, a coluna do Data Extension que contém o ID externo.

Illustration 12 - País, Telefone e ID externo

Aqui pode selecionar os seguintes dados:

Campo	Descrição
País	É o país para onde serão enviados os SMS.
Telefone	É a coluna do Data Extension que contém o telefone. O telefone deve ser numérico, sem espaços, e pode ou não ter um prefixo internacional.
ID externo	Selecione uma coluna da "Extensão de dados" e essas informações serão mostradas na coluna `ID externo` das estatísticas e nas notificações.

2. Configurar o SMS

Nesta etapa deve configurar o remetente, a codificação e o texto do SMS.

Ilustração 13 - Configurar o SMS

Aqui pode inserir os seguintes dados:

Campo	Descrição
Remetente	Texto da remetente. Este parâmetro pode conter até `15 dígitos` ou `11 caracteres alfanuméricos`.
Codificação	Os valores possíveis são `GSM-7` e `UTF-16`. O valor `GSM-7` para remessas normais com codificação GSM-7 e 160 caracteres por mensagem e o valor `UTF-16` para codificação UCS2 (UTF16) e 70 caracteres por mensagem.
Texto	Texto da mensagem. Pode adicionar campos, URLs e emojis personalizados.
Filtros	Antes de adicionar um campo personalizado, pode selecionar um filtro para que esse campo personalizado seja exibido: `lower`: em minúsculas. `upper`: em maiúsculas. `capitalize`: a primeira letra da primeira palavra em maiúsculas. `capitalizeAll`: a primeira letra de cada palavra em maiúsculas. `formatDotComma`: separador de milhares com ponto e separador decimal com vírgula. `formatCommaDot`: separador de milhares com vírgula e separador decimal com ponto. `shorten`: retorna um url encurtado. Deve ser um URL válido.
Campos personalizados	Mostrará o nome das colunas encontradas no seu Data Extension. Quando o SMS for enviado, será substituído pelas informações encontradas nessa coluna.
URLs	Se os URLs estiverem registrados na seção URLs, aparecerão no seletor. Quando o SMS é enviado, o sistema substitui esse URL por um URL curto, para que ocupe menos espaço no SMS.
Emojis	Pode adicionar emojis no texto do SMS. Emojis são caracteres especiais, portanto, eles não são suportados no `GSM-7`. Ao adicionar um emoji, o sistema solicitará que você altere a codificação para `UTF-16` para mostrá-la corretamente.

Se, ao escrever um SMS, você digitar qualquer caractere incompatível com a codificação que estiver usando, será exibida uma mensagem de confirmação para alterar a codificação ou manter a codificação atual.

Ilustração 14 - Mensagem de codificação

3. Configurar parâmetros opcionais

Nesta etapa, deverá configurar parâmetros opcionais, como o nome da campanha, certificado ou não, data de agendamento, data de validade, fuso horário e tags.

Ilustração 15 - Configurar parâmetros opcionais

Aqui você pode inserir os seguintes dados:

Campo	Descrição
Nome da campanha	Nome da sua campanha. Se não for especificado, aparecerá por exemplo: Marketing Cloud Campaign 2020-07-09 10:17:39
Certificado	Indica se o SMS deve ser enviado como certificado ou não. `* As mensagens certificadas têm um custo adicional.`
Data da programação	Data em que o SMS será enviado.
Data de expiração	Data a partir da qual nenhum SMS será enviado.
Fuso horário	Fuso horário da data de programação e data de validade.
Fragmentação	Adicione os fragmentos nos quais deseja dividir a campanha e a frequência de envio para cada fragmento.
Tags	Adicione TAGs que serão mostrados na coluna `TAGs` das estatísticas e no seu Data Extension.

4. Pré-visualização

Na pré-visualização, poderá revisar todos os dados da campanha. Se alguma dessas informações não estiver correta, volte para corrigir.

Ilustração 16 - Pré-visualização

Quando os dados estiverem corretos, pressione o botão ENVIAR AGORA ou PROGRAMAR CAMPANHA. Dependendo de se a campanha tem ou não uma data de programação, aparecerá um botão ou outro.

Ilustração 17 - Botão enviar agora

Ilustração 18 - Botão programar campanha

Pressionar o botão exibirá uma mensagem confirmando que a campanha foi processada com sucesso.

Ilustração 19 - Mensagem da campanha processada

Minhas campanhas de SMS

Nesta seção, você verá uma lista de todas as campanhas enviadas pelo assistente de Nova campanha de SMS.

Na lista, você pode ver o status atual da campanha, os SMS enviados e as ações possíveis, dependendo do status.

Ilustração 20 - Minhas campanhas de SMS

É possível filtrar entre várias datas:

Ilustração 21 - Filtro minhas campanhas de SMS

Dependendo do estado, uma campanha pode ser pausada, reativada, cancelada ou duplicada. Independentemente do estado, poderá ver uma pré-visualização da campanha.

Pausar campanha

Quando a campanha está no estado ENVIANDO, pode ser pausada.

Ilustração 22 - Botão pausar campanha

When pressing the button PAUSE a confirmation message will be shown:

Ilustração 23 - Mensagem pausar campanha

Reativar campanha

Quando uma campanha está em estado PAUSADO, pode ser reativada. A campanha continuará a partir do momento quando foi pausada.

Ilustração 24 - Botão reativar campaign

Pressionar o botão REATIVAR exibirá uma mensagem de confirmação:

Ilustração 25 - Mensagem reativar campanha

Cancelar campanha

Quando uma campanha é cancelada, não pode mais ser reativada.

Ilustração 26 - Botão cancelar campanha

Pressionar o botão CANCELAR exibirá uma mensagem de confirmação:

Ilustração 27 - Mensagem cancelar campanha

Duplicar campanha

Pressionar o botão DUPLICAR exibirá o assistente com os dados preenchidos dessa campanha. O resultado será uma campanha diferente.

Ilustração 28 - Botão duplicar campanha

Pré-visualização

Pressionar o botão PREVIEW exibirá os dados da campanha.

Ilustração 29 - Botão pré-visualização

Ilustração 30 - Pré-visualização

URLs

Em qualquer momento, pode adicionar URLs para inserir nas suas mensagens SMS através de 360NRS; para isso, deve ir para o menu 360NRS SMS no AppExchange e ir para a opção URLs.

Ilustração 31 - URLs

Os URLs adicionados aqui também aparecerão na atividade Enviar SMS dentro do Journey Builder.

Estatísticas

Para ver as estatísticas completas de qualquer envio realizado através de 360NRS, deve ir para o menu 360NRS SMS no AppExchange e ir para o menu Estatísticas.

Ilustração 32 - Estatísticas

Todos os envios feitos através de Marketing Cloud Journey são agrupadas da seguinte forma:

MARKETING_CLOUD_SMS_ANO_MES

Por ejemplo: MARKETING_CLOUD_SMS_2021_01

Lá você pode encontrar as estatísticas completas por canal (SMS) e descarregar as informações em formato CSV e PDF:

Ilustração 33 - Estatísticas do canal

Ilustração 34 - Estatísticas do canal

Ao clicar na campanha, pode ver ainda mais detalhes por campanha:

Ilustração 35 - Estatísticas de campanha

Ilustração 36 - Estatísticas de campanha

Ilustração 37 - Estatísticas de campanha

E, ao clicar no número de envio, você poderá ver ainda mais detalhes onde, além das estatísticas, gráficos, mapa, etc., você poderá ver cada um dos eventos por contato:

Ilustração 38 - Estatísticas de envio

Certificados SMS

Para ver os sms certificados, deve ir ao menu 360NRS SMS menu within the AppExchange e ir ao menu Sms Certified.

Ilustração 39 - Certificados SMS

Configuração

Para ver a configuração, deve ir ao menu 360NRS SMS menu within the AppExchange e ir ao menu Configuração.

Se você precisar ler algum Data Extension ou notificar o status do SMS no seu Data Extension, é necessário inserir os seguintes dados na seção Configuração: Client id, Client secret, Auth URL e Rest URL.

Ilustração 40 - Client id, Client secret, Auth URL and Rest URL

Para obter esses dados, você deve acessar a seção Setup em Marketing Cloud, no canto superior direito:

Ilustração 41 - Setup

A continuação, em Apps > Installed Packages no menu esquerdo, você verá os pacotes instalados:

Ilustração 42 - Installed packages

Ilustração 43 - Installed packages

Ao clicar no pacote 360nrs, você pode ver o Client id, Client secret, Auth url e Rest url.

Ilustração 44 - Installed packages

Depois de obter essas informações, pode inserir os dados na seção Settings dentro de AppExchange > 360NRS SMS:

Ilustração 45 - Configuração

É possível definir a hora de expiração. Se definida, a data de expiração será preenchida no assistente com a data de hoje e a hora definida aqui.

Notificações

Se você também deseja gravar os estados das notificações de entrega dos SMS no seu Data Extension, deve inserir o External Key do Data Extension no qual deseja gravá-los.

Depois que os dados forem inseridos, pressione o botão VERIFICAR e, se tudo estiver correto, pressione o botão SALVAR.

Para que as notificações sejam gravadas corretamente, o seu Data Extension deve conter pelo menos os seguintes atributos: id, campaign, sender, phone, status, date, dateDlr, external, tags e message.

Ilustração 46 - Data Extension

Anexos

Conjunto de caracteres GSM

Conjunto de caracteres `básico` GSM

	0x00	0x10	0x20	0x30	0x40	0x50	0x60	0x70
0x00	@	Δ	SP	0	¡	P	¿	p
0x01	£	_	!	1	A	Q	a	q
0x02	$	Φ	"	2	B	R	b	r
0x03	¥	Γ	#	3	C	S	c	s
0x04	è	Λ	¤	4	D	T	d	t
0x05	é	Ω	%	5	E	U	e	u
0x06	ù	Π	&	6	F	V	f	v
0x07	ì	Ψ	'	7	G	W	g	w
0x08	ò	Σ	(	8	H	X	h	x
0x09	Ç	Θ	)	9	I	Y	i	y
0x0A	LF	Ξ	*	:	J	Z	j	z
0x0B	Ø	ESC	+	;	K	Ä	k	ä
0x0C	ø	Æ	,	<	L	Ö	l	ö
0x0D	CR	æ	-	=	M	Ñ	m	ñ
0x0E	Å	ß	.	>	N	Ü	n	ü
0x0F	å	É	/	?	O	§	o	à

* Caracteres especiais

Conjunto de caracteres `estendidos` GSM

	0x00	0x10	0x20	0x30	0x40	0x50	0x60	0x70
0x00					\|
0x01
0x02
0x03
0x04		^
0x05							€
0x06
0x07
0x08			{
0x09			}
0x0A	FF
0x0B		SS2
0x0C				[
0x0D	CR2			~
0x0E				]
0x0F			\