Chatbot
Fluxo de Atendimento
Webhook na Chatbot
9min
1\ introdução a função de integração via webhook na plataforma jimmy chat Ć© uma ferramenta poderosa que permite a comunicação do chatbot com sistemas externos, potencializando suas funcionalidades e tornando a experiĆŖncia do usuĆ”rio ainda mais rica 2\ configurando a integração via webhook passo a passo para configuração url da requisição especifique a url para a qual o webhook enviarĆ” a requisição esta url pertence ao sistema externo com o qual deseja integrar tipo de requisição get usado para solicitar dados de um recurso post usado para enviar dados para serem processados por um recurso put usado para atualizar um recurso existente patch usado para fazer atualizaƧƵes parciais em um recurso delete usado para deletar um recurso headers informaƧƵes adicionais que podem ser incluĆdas na solicitação por exemplo, autenticaƧƵes, tipo de conteĆŗdo, etc params parĆ¢metros que podem ser adicionados Ć url da solicitação, comumente usados em requisiƧƵes get body corpo da requisição onde os dados sĆ£o incluĆdos, geralmente usado em requisiƧƵes post , put e patch resposta configure como o chatbot deve reagir Ć resposta recebida do webhook por exemplo, pode se determinar a próxima ação do chatbot com base no status da resposta 3\ utilizando campos de contexto campos de contexto coletados durante o fluxo de atendimento podem ser utilizados dentro das configuraƧƵes do webhook, permitindo uma integração personalizada e dinĆ¢mica por exemplo, se vocĆŖ coletou o e mail do usuĆ”rio durante o fluxo, pode inserir esse e mail no corpo ( body ) de uma requisição post para registrĆ” lo em um sistema externo para utilizar um campo de contexto, usa se a sintaxe entre chaves, exemplo {{nome do campo}} 4\ exemplos exemplo verificar status de pedido via webhook objetivo permitir que o usuĆ”rio verifique o status de seu pedido atravĆ©s do chatbot, buscando as informaƧƵes em um sistema externo informaƧƵes solicitadas no chatbot nĆŗmero do pedido {{numero pedido}} configuração do webhook url de destino https //meusistema com/api/statuspedido tipo de requisição get headers (por exemplo, para autenticação) makefile authorization bearer token de autenticacao params (parĆ¢metros adicionados Ć url da requisição) makefile pedido id={{numero pedido}} (observação {{numero pedido}} Ć© um campo de contexto que serĆ” substituĆdo pelo valor coletado no fluxo do chatbot ) resposta (para determinar a próxima ação do chatbot) se status 200 (sucesso) informar o status do pedido ao usuĆ”rio se outro status (erro) informar o usuĆ”rio que ocorreu um erro e pedir para tentar novamente mais tarde exemplo cadastro de usuĆ”rios via webhook objetivo registrar informaƧƵes do usuĆ”rio em um sistema externo após coletar seus dados pelo chatbot informaƧƵes coletadas no chatbot nome do usuĆ”rio {{nome usuario}} e mail do usuĆ”rio {{email usuario}} cpf do usuĆ”rio {{cpf}} configuração do webhook url de destino https //meusistema com/api/cadastro tipo de requisição post headers (por exemplo, para autenticação e definição de formato json) makefile authorization bearer token de autenticacao content type application/json body { "nome" "{{nome usuario}}", "email" "{{email usuario}}", "documento" "{{cpf}}" } (observação {{nome usuario}}, {{email usuario}} e {{cpf}} sĆ£o campos de contexto que serĆ£o substituĆdos pelos valores coletados no fluxo do chatbot ) resposta (para determinar a próxima ação do chatbot) se status 200 (sucesso) agradecer o usuĆ”rio e informar que o cadastro foi realizado se outro status (erro) informar o usuĆ”rio que ocorreu um erro e pedir para tentar novamente mais tarde