WhatsApp

O Riversoft® STCP DirectLink usa a WhatsApp Business Platform, da Meta, para entregar documentos a pessoas pelo WhatsApp e para receber os documentos que elas enviam de volta.

Componente	Quem inicia a conexão	Função
Conector WhatsApp	O Riversoft STCP DirectLink (conexão de saída)	Envia documentos, links seguros e PINs ao celular do destinatário.
Serviço WhatsApp DirectLink	A Meta (conexão de entrada)	Recebe os documentos que os contatos enviam pelo WhatsApp e os grava na caixa postal.

Conexões de saída (conector WhatsApp)

    flowchart LR
    subgraph DL[Riversoft STCP DirectLink]
      SA["Diretório saida"]
      C[Conector WhatsApp]
    end
    SA --> C
    C -->|documento ou link| M[WhatsApp Business Platform]
    M --> W[Celular do destinatário]

O Riversoft STCP DirectLink envia os documentos disponíveis na caixa postal do usuário (diretório saida), por agendamento ou quando o operador inicia a conexão no Riversoft Console Portal. O destinatário vem do nome do arquivo, no formato <celular>@<nome-do-arquivo>: o número é o trecho antes do primeiro @.

Modo de entrega	O que o destinatário recebe
Documento	O próprio arquivo, como documento do WhatsApp.
Link da Meta	Um link para baixar o arquivo, hospedado pela Meta.
Link seguro	Um botão com o link seguro do Riversoft STCP DirectLink para baixar o arquivo.
Link seguro com PIN	O botão com o link seguro e um PIN, exigido no download.

As mensagens usam os templates aprovados para a conta na Meta. O conector WhatsApp só envia: ele não busca arquivos.

Conexões de entrada (serviço WhatsApp DirectLink)

    flowchart LR
    subgraph DL[Riversoft STCP DirectLink]
      S[Serviço WhatsApp DirectLink]
      EN["Diretório entrada"]
    end
    W[Celular do contato] -->|documento| M[WhatsApp Business Platform]
    M -->|webhook| S
    S --> EN

Quando um contato envia um documento ao número de WhatsApp da empresa, a Meta avisa o serviço WhatsApp DirectLink (webhook). O serviço baixa o documento e o grava no diretório entrada da caixa postal do usuário, com o nome <celular>@<nome-do-documento>, para identificar quem enviou.

O serviço WhatsApp DirectLink é cadastrado nos serviços de rede da instância, no Riversoft Console Portal, com o endereço público do webhook, as credenciais da aplicação na Meta e o diretório dos templates.

O que preparar na Meta

Item	Descrição
Conta	Conta do WhatsApp Business, com o número de telefone da empresa.
Aplicação	Aplicação na Meta, com o segredo da aplicação e um token de credencial de sistema.
Webhook	URL pública do serviço WhatsApp DirectLink e o token de verificação, cadastrados na aplicação.
Templates	Templates de mensagem aprovados para os modos de entrega usados.

No usuário, no Riversoft Console Portal, ficam o ID do número de telefone, o token de credencial e o modo de entrega.

Segurança

Para documentos sensíveis, prefira o link seguro com PIN: o arquivo não fica na conversa e o download exige o código.
Publique o serviço WhatsApp DirectLink somente por HTTPS.
Guarde o segredo da aplicação e os tokens da Meta como credenciais.

Webhook