WBudget - Webhooks

Recebimento de dados

Para criar um novo link de recepção de dados via Webhooks, basta acessar o menu Integrações > Webhooks e clicar em Novo.

Figura 1 – Tabela de configuração de webhooks.

Escolha a opção “Ao receber dados via Webhook, gerar uma proposta” e clique em Prosseguir.

Figura 2 – Janela de seleção de evento de webhooks.

Esta opção irá fazer com que o WBudget crie uma proposta, de acordo com os dados enviados para a URL informada a seguir.

Figura 3 – Exemplo de cópia de link de coleta de dados.

Agora é só COPIAR a URL criada e utilizar no sistema que irá realizar o envio das informações.

O WBudget exige que as informações envidas sigam a nomenclatura, de acordo com a tabela a seguir. Esses campos serão processados e utilizados na criação de novas propostas, Clientes e Produtos do sistema.

budget_name Título da proposta que será gerada
budget_company_id Identificador da empresa (WBudget) que irá gerar a proposta
budget_company_name Identificador do Nome da empresa associada à proposta
budget_company_national_id CNPJ/CPF da empresa emissora da proposta
budget_company_address Endereço da empresa emissora da proposta
budget_company_sponsor Nome do contato da empresa emissora da proposta
budget_company_phone Telefone do contato da empresa emissora da proposta
budget_company_email E-mail do contato da empresa emissora da proposta
budget_model Identificador do modelo (WBudget) da proposta
budget_payment Identificador do moddo de pagamento (WBudget) da proposta
budget_description Descrição a ser adicionada na proposta
budget_sign Identificador da assinatura (WBudget) do contratado da proposta
budget_expiration_date Data de Validade da proposta
budget_status Identificador do status (WBudget) da proposta
budget_note Observação a ser adicionada na proposta
budget_company_sponsor Nome do responsável contratado da proposta
external_id Identificador único da oportunidade (sistema de origem)
budget_client_id Identificador único do cliente (sistema de origem)
budget_client_national_id CNPJ ou CPF do cliente
budget_client_phone Telefone do cliente
budget_client_name Nome do Cliente
budget_client_sponsor Nome da pessoa responsável pelo cliente
budget_client_email Email da pessoa responsável pelo cliente
budget_client_address Endereço do cliente
budget_item_id Identificador único dos produtos (sistema de origem) (separado por vírgula)
budget_item_name Nomes dos produtos (sistema de origem) (separado por vírgula)
budget_item_qty Quantidades dos produtos (sistema de origem) (separado por vírgula)
budget_item_value Valores dos produtos (sistema de origem) (separado por vírgula)
budget_item_unit Unidades de medida dos produtos (sistema de origem) (separado por vírgula)
budget_item_description Descrições dos produtos (sistema de origem) (separado por vírgula)
budget_agent_email E-mail do usuário responsável pela proposta



Envio de dados

O WBudget também pode ser utilizado para envio de dados para outros sistemas via webhooks.

O envio pode ser realizado por meio de dois eventos possíveis:

1. Quando uma proposta for marcada como ganha, enviar os dados via webhook.

Nesta modalidade, o envio de dados é realizado quando uma proposta é marcada como ganha (janela de propostas comerciais).

Para configurar, basta selecionar a opção “Quando uma proposta for marcada como ganha, enviar os dados via webhook” e incluir no campo “URL de destino” a URL que irá receber os dados.

Figura 4 – Configuração de URL de destino de dados.

Dessa forma, sempre que uma proposta tiver o seu status alterado para ganho, as informações serão enviadas para esta URL.

Figura 5 – Disparo de evento via proposta ganha.

2. Ao disparar evento de sincronização, enviar os dados via webhook.

Nesta modalidade, os dados são enviados por meio do botão criado na aba “Utilitários” da janela de configuração de propostas comerciais.

Para configurar, basta selecionar a opção “Ao disparar evento de sincronização, enviar os dados via webhook” e incluir a URL que irá receber os dados.

Figura 6 – Configuração de URL de destino de dados.

Em seguida, basta definir um nome para identificação evento!

Figura 7 – Customização do nome do evento.

Este nome será exibido na aba “Utilitários” da janela de configuração de propostas comerciais.

Figura 8 – Botão de disparo de evento (nomenclatura customizada)

Ao clicar, a URL definida nas etapas anteriores irá receber as informações do JSON DE ENVIO (descrito adiante).

JSON DE ENVIO

{ "ID da proposta": "1", "Nome da proposta": "Proposta de venda de computadores", "ID externo da proposta (webhook)": "2", "ID externo da proposta (pipedrive)": "3", "ID externo da proposta (zapier)": "4", "Link da proposta": "http://…", "Moeda da proposta": "BRL", "Taxa de conversão da proposta": "1", "Valor total da proposta": "1000.00", "Valor total da proposta (câmbio) ": "500.00", "Valor total da proposta (BR)": "1.000,00", "Valor total da proposta (câmbio) (BR)": "500,00", "ID do modelo da proposta": "5", "Nome do modelo da proposta": "Modelo A", "ID da forma de pagamento da proposta": "6", "Nome da forma de pagamento da proposta": "3x sem juros", "ID do status da proposta": "7", "Nome do status da proposta": "Aprovada", "Data de criação da proposta": "2020-01-01 12:00", "Data de criação da proposta (BR) ": "01/01/2020 12:00", "Data de validade da proposta": "2020-01-01 12:00", "Data de validade da proposta (BR)": "01/01/2020 12:00", "Descrição da proposta": "Proposta de venda de máquinas para um escritório", "Nota da proposta": "Proposta em negociação", "ID da empresa emissora da proposta": "8", "Nome da empresa emissora da proposta": "WBudget LTDA", "Telefone do contato da empresa emissora da proposta": "(00)00000-0000", "E-mail do contato da empresa emissora da proposta": "[email protected]", "Endereço da empresa emissora da proposta (JSON)": "{street:…, ...}", "Endereço da empresa emissora da proposta (TEXTO)": "Rua Empresa, 123…", "CNPJ/CPF da empresa emissora da proposta": "00.000.000/0001-00", "Nome do contato da empresa emissora da proposta": "Bruno Filardi", "ID externo da empresa emissora da proposta (webhook)": "9", "ID externo da empresa emissora da proposta (pipedrive)": "10", "ID externo da empresa emissora da proposta (zapier)": "11", "ID do cliente": "12", "Nome do cliente": "Apple LTDA", "Telefone do contato do cliente": "(11)1111-1111", "E-mail do contato do cliente": "[email protected]", "Endereço do cliente (JSON) ": "{street:…, ...}", "Endereço do cliente (TEXTO)": "Rua Cliente, 123…", "CNPJ/CPF do cliente": "00.000.000/0002-00", "Nome do contato do cliente": "Steve Jobs", "ID externo do cliente (webhook)": "13", "ID externo do cliente (pipedrive)": "14", "ID externo do cliente (zapier)": "15", "Rua do cliente": "Rua Cliente", "Número da rua do cliente": "1277", "Bairro do cliente": "São Gabriel", "Complemento do endereço do cliente": "Apto 102", "CEP do cliente": "30230-190", "Cidade do cliente": "Belo Horizonte", "Estado do cliente": "MG", "ID do(s) item(s) da proposta": "\"16\",\"17\"", "Nome do(s) item(s) da proposta": "\"Item A\",\"Item B\"", "Unidade de medida do(s) item(s) da proposta": "\"un\",\"un\"", "Quantidade do(s) item(s) a proposta ": "\"1\",\"1\"", "Valor total do(s) item(s) da proposta": "\"99.99\",\"49.99\"", "Valor total do(s) item(s) da proposta (câmbio)": "\"99.99\",\"49.99\"", "Tipo do(s) item(s) da proposta": "\"service\",\"service\"", "Descrição do(s) item(s) da proposta": "\"Descrição de A\",\"Descrição de B\"", "Número de itens da proposta": "2", "Código da Proposta": "A-0001A" }