Links diretos da RCS

Os deeplinks do RCS são URLs especiais que permitem que os usuários iniciem conversas via RCS com a sua empresa diretamente de qualquer canal digital. Quando um cliente clica em um deeplink do RCS, o dispositivo dele abre o aplicativo de mensagens RCS com a sua empresa já definida como destinatária. Você pode até mesmo preencher uma mensagem antecipadamente para ele.

A API RCS Deeplink oferece um ponto de acesso com um único clique que leva os clientes de qualquer ponto de contato digital diretamente para uma conversa RCS. Você pode incorporar esses deeplinks em e-mails, sites, aplicativos móveis ou códigos QR, e seus clientes terão acesso a:

• Chega de etapas manuais para entrar em contato com você
• Maior engajamento
• Ação imediata a partir dos materiais promocionais
• Suporte tanto para dispositivos compatíveis com RCS quanto para o recurso de fallback via SMS

Como gerar links diretos

Antes de gerar links diretos RCS, certifique-se de que você tenha:

• Um agente RCS ativo registrado na Vonage
• O ID do remetente do seu agente RCS (ID da conta externa)
• Credenciais válidas da API da Vonage (autenticação JWT)

Gerar um Deeplink

Envie uma solicitação POST para o endpoint de deeplink da API do Channel Manager:

https://api.nexmo.com/v1/channel-manager/rcs/deeplink/generate

Corpo da solicitação:

{
    "sender_id": "some-example-external-account-id",
    "country": "US",
    "fallback_number": "+14155552671",
    "prefilled_message": "Send me more information on this promotion."
}

Resposta:

{
    "deep_link": "https://tools.vonage.com/rcs/v1/deeplink/egUQB..."
}

Incorporar o Deeplink

Depois de obter a URL do deeplink, você pode incorporá-la onde quer que seus clientes estejam:

Link HTML

<a href="{RETURNED_DEEPLINK_URL}">
  Chat with us about our Spring Sale!
</a>

Código QR

// Use the complete URL from the API response
const deeplinkUrl = response.deep_link;
const qrCode = generateQRCode(deeplinkUrl);

Campanha por e-mail

<button style="background: #007bff; color: white; padding: 12px 24px;">
  <a href="{RETURNED_DEEPLINK_URL}" 
     style="color: white; text-decoration: none;">
    Start a Conversation
  </a>
</button>

Aplicativo móvel

// React Native example
const deeplinkUrl = response.deep_link;

<TouchableOpacity onPress={() => Linking.openURL(deeplinkUrl)}>
  <Text>Contact Support</Text>
</TouchableOpacity>

Veja o que seu cliente vivencia:

1. O cliente clica no seu deeplink a partir de qualquer canal.
2. O sistema verifica o dispositivo (ele é compatível com RCS?).
3. The RCS application that works correctly is opened with the content already filled in.
4. O cliente analisa e edita a mensagem, se quiser.
5. O cliente envia a mensagem para o seu agente RCS.
6. A conversa começa na Messages API.

Limites técnicos

Comprimento da mensagem

A mensagem pré-preenchida tem um limite máximo de 3.072 caracteres. No entanto, recomendamos que você mantenha o texto com menos de 500 caracteres para proporcionar uma melhor experiência ao usuário. Mensagens mais curtas são mais fáceis de ler e editar pelos clientes antes do envio.

Codificação de caracteres

Oferecemos suporte à codificação UTF-8 para todas as mensagens. Ao enviar sua solicitação, não codifique como URL o prefilled_message Você mesmo. Nós cuidamos de toda a codificação automaticamente ao gerarmos o link para você.

Como funciona a geração de links

Sempre que você chama a API, ela cria um deeplink criptografado exclusivo. Mesmo que você envie solicitações idênticas, receberá links diferentes a cada vez. Cada link contém dados criptografados que incluem as informações do seu agente e o conteúdo da mensagem.

Limitação de taxa

Os limites de taxa da API padrão do Channel Manager se aplicam à geração de deeplinks. Se você estiver realizando campanhas de grande volume nas quais utiliza os mesmos parâmetros repetidamente, considere armazenar os deeplinks em cache, em vez de gerar novos a cada uso.

Mais informações

• Referência da API do Channel Manager
• Guia do RCS Agent Builder