Ignorar e ir ao conteúdo principal

Use a API de engajamento de reuniões para registrar e gerenciar reuniões nos registros do CRM. Você pode registrar atividades de reunião no HubSpot ou por meio da API de reuniões. Você pode recuperar, atualizar ou excluir engajamentos de reunião que são incluídos manualmente em um registro, agendados usando a ferramenta de reuniões ou agendados usando a integração de calendário do Google Agenda ou do Office 365.

Abaixo, aprenda os métodos básicos de gerenciamento de reuniões por meio da API. Para visualizar todos os pontos de extremidade disponíveis e seus requisitos, clique na guia Pontos de extremidade na parte superior deste artigo.

Para criar um engajamento de reunião, faça uma solicitação POST para /crm/v3/objects/meetings.

No corpo da solicitação, adicione detalhes da reunião em um objeto de propriedades. Você também pode adicionar um objeto de associações para associar sua nova reunião a um registro existente (por exemplo, contatos, empresas).

No objeto de propriedades, você pode incluir os seguintes campos:

CampoDescrição
hs_timestampObrigatório. Este campo marca a data e a hora em que a reunião ocorreu. Você pode usar um carimbo de data e hora Unix em milissegundos ou no formato UTC.(BETA) Quando o valor da propriedade estiver ausente, será usado o valor padrão hs_meeting_start_time.
hs_meeting_titleO título da reunião.
hubspot_owner_idO ID do proprietário associado à reunião. Este campo determina o usuário listado como o criador da reunião na linha do tempo do registro.
hs_meeting_bodyA descrição da reunião.
hs_internal_meeting_notesAs observações internas que você faz para sua equipe durante uma reunião que não estão incluídas na descrição da reunião do participante.
hs_meeting_external_urlO URL externo do evento de calendário. Por exemplo, pode ser um link de calendário do Google ou do Microsoft Outlook.
hs_meeting_locationOnde a reunião acontecerá. O valor pode ser um endereço físico, uma sala de conferências, um link de videoconferência ou um número de telefone. Isso aparece no convite no calendário do participante.
hs_meeting_start_timeA data e hora de início da reunião. O valor dessa propriedade deve corresponder ao valor de hs_timestamp.
hs_meeting_end_timeA data e hora de término da reunião.
hs_meeting_outcomeO resultado da reunião. Os valores de resultado são programado, concluído, reprogramado, não compareceu e cancelado.
hs_activity_typeO tipo de reunião. As opções se baseiam nos tipos de reunião definidos na sua conta da HubSpot.
hs_attachment_idsOs IDs dos anexos da reunião. Vários IDs de anexo são separados por ponto e vírgula.

Para criar e associar uma reunião a registros existentes, inclua um objeto de associações na solicitação. Por exemplo, para criar e associar uma reunião a contatos, a solicitação pode ser semelhante à seguinte:

O objeto de associações deve incluir:

CampoDescrição
toO registro que deseja associar à reunião, especificado por seu valor de id exclusivo.
typesO tipo de associação entre a reunião e o registro. Inclua associationCategory e associationTypeId. Os IDs de tipo de associação padrão são listados aqui, ou você pode recuperar o valor de tipos de associação personalizados (ou seja, rótulos) por meio da API de associações.

Saiba mais sobre a criação de reuniões em lote clicando na guia Pontos de extremidade na parte superior deste artigo.

Você pode recuperar reuniões individualmente ou em massa. Saiba mais sobre a recuperação em massa clicando na guia Pontos de extremidade na parte superior deste artigo.

Para recuperar uma reunião individual pelo seu ID, faça uma solicitaçãoGET para /crm/v3/objects/meetings/{meetingId}. Você também pode incluir os seguintes parâmetros no URL da solicitação:

DescriçãoParâmetro
propertiesUma lista separada por vírgulas das propriedades a serem retornadas.
associationsUma lista separada por vírgulas dos objetos dos quais você deseja recuperar os IDs de registro associados.

Para solicitar uma lista de todas as reuniões, faça uma solicitação GET para crm/v3/objects/meetings. Você pode incluir os seguintes parâmetros na URL da solicitação:

DescriçãoParâmetro
limitO número máximo de resultados a serem exibidos por página.
propertiesUma lista separada por vírgulas das propriedades a serem retornadas.

Você pode atualizar reuniões individualmente ou em massa. Para atualizar uma reunião individual pelo seu ID, faça uma solicitaçãoPATCH para /crm/v3/objects/meetings/{meetingId}.

No corpo da solicitação, inclua as propriedades de reunião que deseja atualizar. Por exemplo, o corpo da sua solicitação pode ser parecido com o seguinte:

O HubSpot ignorará valores para propriedades somente leitura e inexistentes. Para limpar um valor de propriedade, passe uma string vazia para a propriedade no corpo da solicitação.

Saiba mais sobre a atualização em massa clicando na guia Pontos de extremidade na parte superior deste artigo.

Para associar uma reunião a registros, como um contato e suas empresas associadas, faça uma solicitação PUT para /crm/v3/objects/meetings/{meetingId}/associations/{toObjectType}/{toObjectId}/{associationTypeId}. A URL da solicitação contém os campos a seguir:

CampoDescrição
meetingIdO ID do proprietário da reunião.
toObjectTypeO tipo de objeto ao qual você deseja associar a reunião (por exemplo, contato ou empresa)
toObjectIdO ID do registro ao qual você deseja associar a reunião.
associationTypeIdO ID do tipo de associação entre a reunião e o outro tipo de objeto. Você pode recuperar esse valor por meio da API de associações.

Por exemplo, a URL da sua solicitação pode ser parecida com o seguinte:

https://api.hubspot.com/crm/v3/objects/meetings/17612479134/associations/contact/104901/200

Para remover uma associação entre uma chamada e um registro, faça uma solicitação DELETE para o mesmo URL acima:

/crm/v3/objects/meetings/{meetingId}/associations/{toObjectType}/{toObjectId}/{associationTypeId}

Você pode fixar uma reunião em um registro para que permaneça no topo da linha do tempo do registro. A chamada já deve estar associada ao registro antes da fixação e você só pode fixar uma atividade por registo. Para fixar uma reunião, inclua o id da reunião no campo hs_pinned_engagement_id ao criar ou atualizar um registro por meio das APIs de objeto. Saiba mais sobre como usar as APIs de empresas,contatos, negócios, tickets e objetos personalizados.

Você pode excluir reuniões individualmente ou em massa, o que adicionará a reunião à lixeira no HubSpot. Você pode restaurar posteriormente a reunião da linha do tempo do registro.

Para excluir uma reunião individual pelo seu ID, faça uma solicitaçãoDELETE para /crm/v3/objects/meetings/{meetingId}.

Saiba mais sobre a exclusão em massa clicando na guia Pontos de extremidade na parte superior deste artigo.