Webhook

Crie integrações com o Hubspot utilizando os webhooks disponibilizados neste tópico!

Para criar e atualizar contatos no Hubspot

Após validar se o contato possui nome e e-mail, e outras informações que estejam em propriedades de contato no Hubspot, você pode atualizar as informações e criar novos contatos na base do Hubspot.

Url: https://server.spread.chat/landbot/createLead/colocar_aqui_id_gerado_pela_spread 

Método: POST

Body:

{
"contactToken": "{{contacttoken}}",
"name": "{{name}}",
"email": "{{email}}",
"phone": "{{phone}}"
}

Retornar o valor de uma propriedade

É possível retornar o valor guardado dentro de uma propriedade de contato usando como referencia o nome interno dessa propriedade e salvando seu conteúdo em uma variavel criado no Builder.

Url: https://server.spread.chat/landbot/getProperties

Método: POST

Body:
{
"contactToken": "{{contacttoken}}",
"props": [
"nome interno da propriedade do hubspot"
]
}

Modificar o valor de uma propriedade de contato

Aqui é possível editar o valor interno de uma propriedade de contato com informações coletadas no chatbot ou para marcar os contatos que entraram por algum caminho especifico.

As propriedades devem ser preenchidas conforme a configuração da mesma no Hubspot. Pode ser qualquer campo aberto, mas caso seja um propriedade com opções de seleção, ela deve ser preenchida conforme o valor do rotulo interno. Essa informação é acessada diretamente nas configurações da propriedade no Hubspot.

// Url: https://server.spread.chat/landbot/setProperties

Método: POST 

Body:

{
"contactToken": "{{contacttoken}}",
"props": {
"nome interno propriedade do hubspot": "valor de como será preenchido"
}
}

Direcionamento com base no fluxo de trabalho

Essa configuração permite identificar fluxos de trabalhos ativos e com isso realizar construção de fluxos e direcionamentos específicos para cada fluxo.

// Url: https://server.spread.chat/landbot/getType/colocar_aqui_id_gerado_pela_spread

Método: POST 

Body:

{
"contactnumber": "{{phone}}",
"interval": 48,
"lastChatInterval": 0
}

Importante: Precisa criar a variável workflowId e em seguida conectar um keyword jump com a variável criada, informando o ID do fluxo que deseja identificar.

Revezamento entre atendentes

O revezamento é uma configuração que garante que os contatos que chegam sejam distribuídos de forma equilibrada entre os atendentes que desejar.

Importante: Após realizar essa configuração é necessário que conecte esse webhook a um keyword jump usando a variavel criada e incluindo o número de opções informadas na url.

// Url: https://us-central1-spread-chat-333716.cloudfunctions.net/hubspot-api-interface/getRandomInt

Método: POST

Body:

{
"min": 1,
"max": 2
}

Você pode realizar o revezamento entre mais atendentes basta em "max" colocar o número que deseja.

Criação de negócio

Criar um negócio envolve configurar um fluxo que permita coletar informações dos usuários e registrar essas informações de forma eficiente.

// Url: https://us-central1-spread-chat-333716.cloudfunctions.net/hubspot-api-interface/createDeal/[PORTAL-ID]

Método: POST

Body:

{
"contactId": "22301",
"properties": {
"dealname": "Nome do negócio",
"dealstage": "22503826",
"pipeline": "7773810",
"prop-hubspot": "example"
}
}

Observações:

dealstage: Id da etapa que o negócio será criado

pipeline: Id do pipeline que o negócio será criado

Qualquer propriedade adicional pode ser adicionada, exemplo:

"nome_interno_da_prop": "novo valor"

Criação de Tickets

Criar um ticket no chatbot pode ser uma ótima maneira de gerenciar solicitações de suporte ou feedback de usuários de forma organizada.

// Url: https://us-central1-spread-chat-333716.cloudfunctions.net/hubspot-api-interface/createTicket/[PORTAL-ID]

Método: POST

Body:

{
"contactId": "[id-do-contato]",
"properties": {
"subject": "Nome do ticket",
"hs_pipeline_stage": "1",
"hs_pipeline": "0",
"hs_ticket_priority": "HIGH"
}
}

Observações:

subject: Nome do ticket

hs_pipeline_stage: Id do pipeline

hs_pipeline: Id do pipeline

Qualquer propriedade adicional pode ser inserida, exemplo:

"nome_interno_da_prop": "novo valor"

Essas integrações garantem que as informações sejam transmitidas de forma eficiente e segura, melhorando a agilidade do atendimento e a personalização da experiência dos seus clientes.