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

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

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

Body:

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

Criar 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]

Body:

{
"contactId": "22301",
"properties": {
"dealname": "Nome do negócio",
"dealstage": "22503826",
"pipeline": "7773810",
"amount": 22,
"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"

Atualizar negócio

Envolve configurar um fluxo que permita coletar novas informações do usuário e modificar os dados existentes.

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

Body:

{
"dealId": "1792772",
"properties": {
"dealname": "Novo nome do negócio",
"amount": 22,
"prop-hubspot": "example"
}
}

Observações:

Qualquer propriedade adicional pode ser atualizada, 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]

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"

Atualização de Tickets

Atualizar um ticket é uma maneira eficaz de gerenciar solicitações em andamento e garantir que os usuários tenham acesso às informações mais recentes sobre seus tickets.

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

Body:

{
"ticketId": "[id-do-ticket]",
"properties": {
"subject": "Nome do ticket"
}
}

Observações:

Qualquer propriedade pode ser atualizada, 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.