Skip to main content
Acessar Studio

Disparar robô via WhatsApp

O Roberty permite disparar um robô enviando uma mensagem de WhatsApp para um número conectado ao seu workspace. É uma forma prática de iniciar automações pelo celular ou integrar o robô a fluxos que já usam o WhatsApp como canal de comunicação.

Como funciona​

Você configura um comando no robô — uma palavra ou frase-chave. Quando esse comando é enviado (precedido de /) para o número de WhatsApp vinculado ao dispositivo, o robô é iniciado automaticamente.

Pré-requisitos​

Antes de configurar este recurso, você precisa:

  1. Ter um bot de WhatsApp criado no dispositivo — acesse a seção Dispositivos no Studio, selecione o dispositivo e configure o bot na aba WhatsApp. Consulte: WhatsApp.
  2. Ter o dispositivo com o bot vinculado ao robô — o mesmo dispositivo que hospeda o bot de WhatsApp deve estar vinculado ao robô.

Para vincular um dispositivo ao robô, consulte: Vincular dispositivo.

Configurando o comando de WhatsApp​

  1. Abra o Designer do robô desejado.

  2. Clique no ícone de engrenagem (⚙️) para abrir as configurações.

  3. Localize o campo Comando WhatsApp.

  4. Digite a palavra-chave do comando (sem o / — o sistema adiciona automaticamente).

    Exemplo: Se você digitar executar, o comando para disparar o robô será /executar.

  5. Clique no ícone de salvar e confirme.

Restrições do comando
  • Comandos com apenas uma letra não são permitidos.
  • Para remover um comando existente, salve o campo em branco.

Disparando o robô​

Com o comando configurado, envie uma mensagem para o número de WhatsApp do bot com o formato:

/executar

O robô será iniciado imediatamente no dispositivo vinculado.

Passando argumentos pelo WhatsApp​

Você pode enviar dados adicionais junto com o comando, separando-os por espaço:

/executar argumento1 argumento2

Esses argumentos ficam disponíveis no robô durante a execução:

DadoComo acessar (código personalizado)
Tudo que veio após o comandoargs.whatsApp.content
Número que enviou o comandoargs.whatsApp.from

Exemplo prático: O comando /processar 05.541.242/0001-06 envia um CNPJ como argumento, que o robô pode capturar via args.whatsApp.content.

Enviando respostas via WhatsApp​

Para que o robô responda ao usuário que enviou o comando, use a ação de envio de mensagens do WhatsApp com o valor args.whatsApp.from como destinatário.

Atenção ao uso em grupos

Se o número do bot fizer parte de um grupo, qualquer membro do grupo poderá disparar o robô com o comando. Mensagens de resposta enviadas para args.whatsApp.from em um grupo serão entregues para o grupo inteiro, não para o usuário individualmente.

Próximos passos​