Utilizar seu próprio provedor de SMS
Sobre a utilização de seu próprio provedor de SMS
Com as distribuições de SMS, você pode enviar pesquisas ou links de pesquisa diretamente para os telefones dos seus entrevistados por meio de texto. Muitos clientes optam por usar a configuração pré-configurada da Qualtrics, mas se sua empresa tiver um relacionamento preexistente com um provedor de SMS, você poderá usá-lo para enviar distribuições de SMS no Qualtrics.
A Qualtrics não recomenda nenhum provedor em detrimento de outro, mas recomendamos que os clientes pesquisem o melhor provedor de serviços para seus negócios. Todos os provedores listados nesta página podem ser integrados à Qualtrics, mas a cobertura e a disponibilidade de recursos podem variar em diferentes regiões e países.
Where in the Platform You Can Use Your Own SMS Provider
You can set up your own SMS provider for just about any project or feature compatible with SMS. Isso inclui:
- SMS in a survey project
- Diretório XM
- XM Directory Lite
- Compatible Employee Experience projects
Configuração de administrador necessária no Qualtrics
- As distribuições de SMS são um recurso complementar não incluído na licença padrão da Qualtrics. Verifique se a sua licença tem SMS. Você pode confirmar isso com seu Executivo de contas.
- Entre em contato com seu executivo de conta e solicite que ele lhe envie o plug-in do seu provedor de SMS escolhido. Os provedores que oferecemos suporte atualmente incluem:
- Twilio
- Vincular mobilidade
- Sinch LiveLink
- Infobip
- MessageMedia
- Vonage
- MessageBird
Atenção: se você estiver interessado em usar um provedor de SMS que não está listado, fale com seu executivo de conta sobre a ativação de seu provedor de serviços preferido.
- Faça login na sua conta Qualtrics.
- Use o menu de navegação para ir para Admin.
- Clique em Extensões.
- Utilize a barra de pesquisa para encontrar seu provedor de SMS.
- Clique no nome da extensão.
- Clique em Adicionar conta.
- Preencha todos os campos necessários para conectar sua conta ao Qualtrics. Consulte os seguintes guias para campos específicos do seu provedor de SMS:
Twilio
Esta seção descreve as etapas a serem executadas para conectar sua conta Twilio à Qualtrics.
Etapas no Qualtrics
Solicitar que um administrador da marca conclua as etapas necessárias na Qualtrics.
Estes são os campos que seu Administrador da marca precisará preencher para conectar uma conta Twilio.
- Nome: insira qualquer nome que ajudará você a identificar posteriormente para que serve esta conexão/para que serve.
- SID da conta: SID da conta Twilio utilizado para acesso API. Você pode encontrar isso no dashboard depois de efetuar logon no Twilio.
- Token de autenticação: token de autenticação Twilio usado para acesso API. Você pode encontrar isso no dashboard depois de efetuar logon no Twilio.
- Número de telefone, ID do remetente ou ID do serviço de mensagens Twilio: o número ou ID que será usado como o número ‘DE’ ao enviar uma mensagem SMS. Este pode ser um dos seguintes:
- Um número específico, por exemplo, 13531234567. Este deve ser um número comprado em sua conta Twilio. Sempre inclua o código do país no início do número.
Qdica: Você também pode usar códigos curtos. Consulte a documentação de Twilio para obter mais detalhes.
- Um senderId alfanumérico, por exemplo, Qualtrics. Observe que isso deve ser configurado em Twilio para ser suportado. Consulte a documentação de Twilio.
- Um ID do serviço de mensagens Twilio. Consulte a documentação de Twilio sobre serviços de mensagens. As IDs de serviço de mensagens começam com MG e são encontradas na seção Propriedades da guia Serviço de mensagens após o acesso ao Twilio.
Qdica: O ID do serviço de mensagens Twilio dá a você mais controle sobre números regionais e roteamento inteligente.
- Um número específico, por exemplo, 13531234567. Este deve ser um número comprado em sua conta Twilio. Sempre inclua o código do país no início do número.
Depois de conectar uma conta Twilio, siga estas etapas e selecione Dar acesso a todos os usuários.
Etapas em Twilio
Você precisará configurar webhooks para seus números ou serviços de mensagens. Consulte informações adicionais sobre webhooks de Twilio aqui.
Configuração de Webhooks
O URL para seu webhook assume a seguinte forma. Observe que vários parâmetros devem ser editados com informações da sua licença Qualtrics / marca.
https://<DatacenterID>.qualtrics.com/distribution-providers/v1/Receive/distribution/message/twilio-sms/<ID da organização>
O método deve ser HTTP/POST.
Configuração de Webhooks para NúmerosPara
configurar o webhook no Twilio para um número:
- Selecione Números de gerente.
- Vá para a seção Números ativos.
- Selecione o número que deseja configurar.
- No cabeçalho Mensagens, escolha configurar com Webhooks.
- Defina a mensagem para Webhook, defina o URL para o seguinte, com o < > e tudo dentro substituído pelos parâmetros da sua organização:
https://<DatacenterID>.qualtrics.com/distribution-providers/v1/Receive/distribution/message/twilio-sms/<ID da organização≫ - Certifique-se de que ele esteja marcado como um método HTTP/POST.
- Você também pode indicar o URL de backup (o que fazer se “Falha no manipulador primário”) for o mesmo URL e método.
Configurando Webhooks para um serviço de mensagemSe
você configurou seus números para usar um serviço de mensagens, você adicionará webhooks de forma diferente do que faria para um único número.
Na caixa Twilio:
- Selecione Mensagens programáveis.
- Selecione o serviço de mensagens que você deseja configurar ou crie um novo. Consulte a documentação do suporte Twilio para obter mais detalhes.
- Depois de selecionar seu serviço de mensagens, selecione a seção Integração.
- Você deve configurar as mensagens de entrada para incluir o URL acima com os parâmetros de sua organização.
- Certifique-se de que ele esteja marcado como um método HTTP/POST.
- Você também pode indicar que o URL de backup deve ser o mesmo URL e método.
Vincular mobilidade
Esta seção descreve as etapas a serem executadas para conectar sua conta do Link Mobility ao Qualtrics.
ETAPAS NA QUALTRICS
Solicitar que um administrador da marca conclua as etapas necessárias na Qualtrics.
Estes são os campos que seu Administrador da marca precisará preencher para conectar uma conta Vincular mobilidade.
- Nome: insira qualquer nome que ajudará você a identificar posteriormente para que serve esta conexão/para que serve.
- Nome de usuário: o nome de usuário da sua conta Link Mobility.
- Senha: a senha da sua conta do Link Mobility.
- Número de telefone/ID do remetente: o número ou ID que será utilizado como o número ‘DE’ ao enviar uma mensagem SMS. Este pode ser um dos seguintes:
- Um número específico, por exemplo, +35312345678. Incluir sempre um sinal positivo (+ ) e o código do país no início do número.
- Um ID de emissor alfanumérico, por exemplo, Qualtrics. Observe que isso deve ser configurado no Link Mobility para ser suportado.
- ID de plataforma fornecido por Link Mobility: o ID da plataforma fornecido a você pelo Link Mobility.
- ID do parceiro de plataforma fornecido pelo Link Mobility: o ID do parceiro de plataforma fornecido por Link Mobility.
Qdica: Se você precisar de ajuda para descobrir esses IDs, recomendamos que entre em contato com a equipe de suporte do Link Mobility.
- Host do ponto de acesso fornecido por Link Mobility: o host do ponto de acesso que é fornecido a você pelo Link Mobility. Inclua apenas o anfitrião base do ur. Por exemplo, https://wsx.sp247.net/sms se torna wsx.sp247.net.
- ID do portão fornecido por Link Mobility: o ID do portão fornecido a você por Link Mobility. As credenciais para este GateID devem corresponder ao seu Nome de usuário e Senha para fins de autenticação.
Depois de conectar uma conta do Link Mobility, siga estas etapas e selecione Dar acesso a todos os usuários.
Sinch
Esta seção descreve as etapas a serem executadas para conectar sua conta Sinch à Qualtrics.
CONFIGURANDO A AMPLIAÇÃO DA QUALTRICS
Solicitar que um administrador da marca conclua as etapas necessárias na Qualtrics.
CONFIGURANDO SUA CONTA DE SINCRONIZAÇÃO
Para ativar o relatório de status, vá para a seção webhooks do aplicativo API de conversação e selecione ‘Adicionar webhook’.
- O tipo de destino deve ser HTTP.
- O URL de destino deve estar no formato “https://<DatacenterID>.qualtrics.com/distribution-providers/v1/receive/distribution/status/sinch/<OrganizationID>“
- O token secreto deve ser um segredo que você deve gerar e usar para relatórios de status e SMS bidirecional. Anote isso, pois você precisará usá-lo ao configurar sua extensão no Qualtrics.
- Os acionadores devem ser EVENT_DELIVERY e MESSAGE_DELIVERY
- O tipo de destino deve ser HTTP.
- O URL de destino deve estar no formato “https://<DatacenterID>.qualtrics.com/distribution-providers/v1/receive/distribution/message/sinch/<OrganizationID>”
- O token secreto deve ser um segredo que você deve gerar e usar para relatórios de status e SMS bidirecional. Anote isso, pois você precisará usá-lo ao configurar sua extensão no Qualtrics.
- Os acionadores devem ser MESSAGE_INBOUND
CONECTANDO SUA CONTA DE SINCRONIZAÇÃO À QUALTRICS
Estes são os campos que seu Administrador da marca precisará preencher para conectar uma conta Sinch.
- Nome: insira qualquer nome que o ajude a identificar mais tarde o que essa conexão é / para que serve.
- ID do cliente OAuth: pode ser criado no dashboard após o logon em Sinch. Você criará um par de ID de cliente e secreto, o ID do cliente deve ser colocado aqui e a chave secreta abaixo.
- Segredo do cliente OAuth: o segredo do par de ID/segredo do cliente criado acima.
- Centro de dados da conta Sinch (UE ou EUA): a região em que seu app API de conversação está localizado. Isso pode ser encontrado no painel após o login em Sinch.
- ID do projeto de conta Sinch: seu ID de projeto de conta Sinch. Você pode encontrar isso no dashboard após efetuar o logon em Sinch.
- Número de telefone ou ID do remetente: o número ou ID que será utilizado como número ‘DE’ ao enviar uma mensagem SMS. Este pode ser um dos seguintes:
- Um número específico, por exemplo, 35312345678. Sempre inclua o código do país no início.
- Um ID de emissor alfanumérico, por exemplo, Qualtrics.
- ID do app de conversação Sinch: o ID para seu app API de conversação. Você pode encontrar isso no dashboard após efetuar o logon em Sinch.
- Webhook Secret Token: Este é o segredo que você criou ao configurar seus webooks para relatórios de status e mensagens bidirecionais.
Depois de conectar uma conta Sinch, siga estas etapas e selecione Dar acesso a todos os usuários.
Infobip
Esta seção descreve as etapas a serem executadas para conectar sua conta Infobip à Qualtrics.
Etapas no Qualtrics
Estes são os campos que seu Administrador da marca precisará preencher para conectar uma conta Infobip.
- Nome: insira qualquer nome que ajudará você a identificar posteriormente para que serve esta conexão/para que serve.
- Chave API pública: sua chave API Infobip. Para gerar uma chave, efetue o logon no seu portal Infobip e clique em Nova chave API. Se você já tiver uma chave API, copie a chave existente em vez de gerar uma nova chave.
- Senha do Webhook: forneça seu nome de usuário e senha do Infobip nos campos de senha e nome de usuário do Webhook. Depois de concluir essa configuração, entre em contato com o suporte da Infobip e peça que definam a Autenticação Básica para o seu webhook. Você precisará fornecer a eles um nome de usuário e uma senha para usar. Não use caracteres especiais em seu nome de usuário.
- Nome de usuário do Webhook: consulte a senha do webhook acima.
- URL base fornecido por Infobip: Seu URL de base Infobip. Para encontrar seu URL, efetue logon no portal Infobip e copie o URL de base API. Ao colar seu URL no Qualtrics, remova a parte https:// do URL.
- Número de telefone ou ID do remetente: o número ou ID que será o número “DE” ao enviar SMS. Para encontrar seu número de telefone/ID do emissor, efetue o logon no seu portal Infobip. Ao adicionar seu número ou código, não adicione prefixos (+ ou 00). Este pode ser um dos seguintes:
- Um número específico, por exemplo, 13531234567. Este deve ser um número comprado na sua conta Infobip. Sempre inclua o código do país no início do número.
- Um ID de emissor único, alfanumérico ou numérico, por exemplo, QUALTRICS ou 868686.
Qdica: Se você pretende usar SMS bidirecional, precisará usar um número específico e não uma ID alfanumérica.
Ao entrar em contato com o suporte do Infobip, você precisará fornecer o(s) URL(s) do webhook. Para ativar a geração de relatórios de status, o URL do webhook estará no formato:
- https://<DatacenterID> .qualtrics.com/distribution-providers/v1/Receive/distribution/status/infobip-sms/<OrganizationID>
Para ativar o SMS bidirecional, o URL do webhook estará no formato:
- https://<DatacenterID> .qualtrics.com/distribution-providers/v1/Receive/distribution/message/infobip-sms/<OrganizationID>
Depois de conectar uma conta InfoBip, siga estas etapas e selecione Dar acesso a todos os usuários.
MessageMedia
Esta seção descreve as etapas a serem executadas para conectar sua conta do MessageMedia à Qualtrics.
Configurando sua conta MessageMedia
Para obter credenciais importantes que permitirão que você se conecte à Qualtrics, você deve primeiro criar uma nova chave em sua conta MessageMedia.
Siga estas etapas para criar sua chave em Autenticação padrão.
Salve a chave e a chave secreta da API. A chave atuará como seu nome de usuário e o segredo atuará como sua senha quando você se conectar ao Qualtrics.
Configuração da extensão Qualtrics
Solicitar que um administrador da marca conclua as etapas necessárias na Qualtrics.
Estes são os campos que seu Administrador da marca precisará preencher para conectar uma conta MessageMedia.
- Nome: insira qualquer nome que ajude você a identificar posteriormente para que serve essa conexão/para que serve.
- Nome de usuário: sua chave API MessageMedia.
- Senha: Seu segredo de API MessageMedia.
- Número de telefone, remetente alfanumérico: o número ou ID que será usado como número “DE” ao enviar uma mensagem SMS. Este pode ser um dos seguintes:
- Um número específico, por exemplo, 35312345678.
- Um ID de emissor alfanumérico, por exemplo, Qualtrics.
Qdica: Se você quiser usar SMS bidirecional (SMS interativo), precisará usar um número específico e não uma ID de remetente alfanumérica.
- Enterprise Webhook – Chave pública: a chave pública usada para verificar chamadas de retorno e SMS bidirecional. Para obter essa chave, entre em contato com o representante da MessageMedia.
Depois de conectar uma conta MessageMedia, siga estas etapas e selecione Dar acesso a todos os usuários.
Vonage
Esta seção descreve as etapas a serem executadas para conectar sua conta Vonage à Qualtrics.
Etapas no Qualtrics
Estes são os campos que seu Administrador da marca precisará preencher para conectar uma conta do Vonage.
- Nome: insira qualquer nome que ajudará você a identificar posteriormente para que serve esta conexão/para que serve.
- SID da conta: ID da sua conta Vonage.
- Token de autorização: token de autorização de fornecedor usado para acesso à API. Você pode encontrar isso em seu painel de instrumentos depois de fazer login no Vonage.
- Número de telefone, ID do remetente ou ID do serviço de mensagem Vonage: o número ou ID que será usado como número “DE” ao enviar uma mensagem SMS. Isso pode ser um dos seguintes:
- Um número específico, por exemplo, 35312345678. Inclua sempre o código do país no início, mas não inclua outros prefixos (+ ou 00).
- Um ID alfanumérico do remetente, por exemplo, Qualtrics.
Qdica: Se você pretende usar SMS bidirecional, precisará usar um número específico e não uma ID de remetente alfanumérica.
- Segredo da assinatura: o segredo usado para gerar sua assinatura de webhook.
Depois de conectar uma conta Vonage, siga estas etapas e selecione Dar acesso a todos os usuários.
MessageBird
Esta seção descreve as etapas a serem executadas para conectar sua conta MessageBird à Qualtrics.
Passos em Messagebird
Um administrador MessageBird precisará executar os seguintes passos antes de conectar sua conta MessageBird.
- Faça login no Messagebird.
- Vá para a guia Desenvolvedores.
- Clique em Configurações de API.
- Insira seu URL de relatórios de status. O URL deve estar no seguinte formato: https://DatacenterID.qualtrics.com/distribution-Providers/v1/Receive/distribution/status/twilio-sms/ID da organização.
Qdica: Para encontrar seus IDs de data center e de organização, consulte Encontrar IDs do Qualtrics.
Se você planeja usar SMS bidirecional, você deve concluir as etapas adicionais abaixo:
- Vá para a guia Flow Builder.
- Clique em Criar novo fluxo.
- Selecione Modelos.
- Selecione o modelo Chamar ponto de acesso HTTP com SMS.
- Para o Método, selecione LANÇAR.
- Para o URL, insira seu URL no seguinte formato. https://DatacenterID>.qualtrics.com/distribution-providers/v1/Receive/distribution/message/twilio-sms/OrganizationID.
Qdica: Para encontrar seus IDs de data center e de organização, consulte Encontrar IDs do Qualtrics.
- Clique em Salvar.
- Publique seu fluxo.
Etapas no Qualtrics
Estes são os campos que seu Administrador da marca precisará preencher para conectar uma conta MessageBird.
- Nome: insira qualquer nome que ajude você a identificar posteriormente para que serve essa conexão/para que serve.
- Chave de assinatura: Chave de assinatura MessageBird usada para verificação de mensagens recebidas. Você pode encontrar isso na seção Desenvolvedor da sua conta MessageBird.
- Token de acesso: Token de acesso MessageBird usado para acesso à API. Você pode encontrar isso em seu painel de instrumentos depois de fazer login no MessageBird.
- Número de telefone ou ID do remetente: o número ou ID que será utilizado como número ‘DE’ ao enviar uma mensagem SMS. Isso pode ser um dos seguintes:
-
- Um número específico, por exemplo, 35312345678. Inclua sempre o código do país no início, mas não inclua outros prefixos (+ ou 00).
- Um ID alfanumérico do remetente, por exemplo, QUALTRICS.
Qdica: Se você pretende usar SMS bidirecional, precisará usar um número específico e não uma ID de remetente alfanumérica. -
Depois de conectar uma conta MessageBird, siga estas etapas e selecione Dar acesso a todos os usuários.