Bom dia, pessoal! Esse tópico vai ser bem curtinho e resumido, para ajudar quem precisa fazer o direcionamento de usuários no fluxo. Tenho visto dúvidas a respeito desse tema e talvez essa doc possa ajudar.
São necessárias duas requisições e exatamente na seguinte ordem:
Primeira Requisição
Verbo: POST
URL: https://{{id_do_contrato}}.http.msging.net/commands
Header
Content-Type: application/json
Authorization: Key {YOUR_ROUTER_TOKEN}
Body
{
"id": "{{$guid}}",
"to": "[email protected]",
"method": "set",
"uri": "/contexts/{{contact.identity}}/Master-State",
"type": "text/plain",
"resource": "{{idDoSubbot}}@msging.net"
}
Obs:
- A variável {{$guid}} é gerada automaticamente para uso no Postman
- A variável {{contact.identity}} é o número de telefone do usuário + o identificador padrão do Whatsapp.
Exemplo: [email protected] - A variável {{idDoSubbot}} é o id do bot que será direcionado. Essa informação pode ser obtida na página home do seu bot. Em baixo do nome terá uma chave-valor de nome “Id”, com o valor desejado à frente.
Exemplo:
Segunda Requisição
Verbo: POST
URL: https://{{id_do_contrato}}.http.msging.net/commands
Header
Content-Type: application/json
Authorization: Key {YOUR_ROUTER_TOKEN}
Body
{
"id": "{{$guid}}",
"to": "[email protected]",
"method": "set",
"uri": "/contexts/{{contact.identity}}/stateid@{{flow-identifier}}",
"type": "text/plain",
"resource": "{{state-id}}"
}
Obs:
- A variável {{$guid}} é gerada automaticamente para uso no Postman
- A variável {{contact.identity}} é o número de telefone do usuário + o identificador padrão do Whatsapp.
Por exemplo: [email protected] - A variável {{flow-identifier}} pode ser obtida ao abrir o Builder do subbot desejado, clicar nas configurações que ficam no painel à esquerda, clicar em Identificador do Fluxo e copiar o seu valor.
Exemplo: - A variável {{state-id}} é o identificador do bloco que você enviará o contato. Alguns pontos devem ser observados neste momento.
- O bloco que receberá o usuário não exibirá nenhum conteúdo e executará apenas as condições de saída.
- É uma boa prática criar este bloco separado para receber o usuário e que tenha a condição de aguardar “Entrada do usuário”.
Exemplo: - A imagem acima é um bom exemplo de como este bloco deve ser. Ele é paralelo ao bloco “Início”, aguarda um input do usuário para iniciar a conversa e somente depois que envia o usuário para o primeiro bloco do fluxo, neste caso denominado “valida”.
- Para coletar o valor de {{state-id}} basta clicar com o botão direito em cima do bloco e clicar em “Copiar Id”
Exemplo:
As duas requisições devem ser realizadas na ordem que aqui se apresenta. Em caso de disparo de mensagem ativa com um redirecionamento personalizado, é recomendado primeiro efetuar o disparo da mensagem ativa para depois executar as etapas deste documento.