BètaWebhooks gebruiken in agents

Gebruik webhook-acties in agents om gegevens naar externe systemen te verzenden en van die systemen te ontvangen. Je kunt webhook-acties in de agent-builder configureren om HTTP-verzoeken (bijvoorbeeld GET of POST) te doen, externe processen te activeren of gegevens op te halen.

Webhook-acties helpen bij het koppelen van agents aan externe tools zonder dat er aangepaste integraties nodig zijn. U kunt bijvoorbeeld dealgegevens naar een extern systeem verzenden om de afhandeling te starten, of klantinformatie van een ander platform ophalen en deze gebruiken in de uitvoer van uw agent.

Let op: je kunt toegang tot AI-functies beheren in je AI-instellingen en configureren welke gegevens worden gedeeld. Bekijk HubSpot's AI Trust FAQ's en AI Model Cards voor gedetailleerde informatie over AI-beveiligingscontroles, gegevensgebruik en compliance.

Voordat je aan de slag gaat

Bekijk de vereisten en aandachtspunten voordat je webhooks in agents gaat gebruiken.

• Een superbeheerder moet de volgende schakelaars inschakelen in de AI-instellingen:

  • Geef gebruikers toegang tot generatieve AI-tools en -functies

  • CRM-gegevens

  • Conversiegegevens van klanten

  • Bestandsgegevens

  • Geef gebruikers toegang tot Breeze Assistant

Voeg een webhook-actie toe aan een agent

Voeg een webhook-actie toe in de agentbouwer om gegevens naar een extern systeem te verzenden of gegevens uit een extern systeem op te halen. Gebruik het vervolgkeuzemenu 'Methode' om te selecteren hoe de agent moet communiceren met de webhook-URL:

• GET: haal waarden op uit een ander systeem. Gebruik GET-verzoeken wanneer de agent later tijdens de uitvoering van de agent informatie uit een extern systeem moet raadplegen, zoals een abonnementsstatus, bestelstatus of veld in het klantprofiel.

• POST: stuur waarden naar een ander systeem. Gebruik POST-verzoeken wanneer de agent iets buiten HubSpot moet activeren of bijwerken, zoals het aanmaken van een afhandelingsverzoek, het verzenden van een melding of het bijwerken van een extern record.

Een webhook-actie toevoegen:

1. Klik in je HubSpot-account op Meer en ga vervolgens naar Agents > Agent Hub. Als Meer niet in je account wordt weergegeven, ga dan rechtstreeks naar Agents > Agent Hub.

2. Klik op het tabblad Agenten.

3. Klik op 'Bewerken' op de kaart van een bestaande agent of maak een nieuwe agent aan.

4. Klik in de agent-builder op Actie toevoegen in het gedeelte Acties.

5. Voer in het rechterpaneel 'Een webhook verzenden ' in het zoekveld in. Klik vervolgens op de actie 'Een webhook verzenden '.

6. Klik op het vervolgkeuzemenu 'Methode' en selecteer het verzoektype (bijv. POST of GET).

7. Voer in het veld 'Webhook-URL' de URL in waarnaar het verzoek moet worden verzonden.

8. Klik op het vervolgkeuzemenu 'Authenticatietype' en selecteer een authenticatietype.

9. Configureer, afhankelijk van de geselecteerde methode (bijv. GET of POST), de waarden die in het verzoek moeten worden opgenomen.

   • Voor GET-verzoeken klikt u in het gedeelte 'Queryparameters' op 'Statische waarde toevoegen' om de namen en waarden toe te voegen die aan de webhook-URL moeten worden toegevoegd.

   • Voor POST-verzoeken klikt u in het gedeelte Verzoektekst op Statische waarde toevoegen om waarden toe te voegen die in de verzoektekst van de webhook moeten worden opgenomen.

10. Klik op ‘Testen’ om de webhook-actie te testen. Controleer het antwoord om te bevestigen dat het verzoek correct is geconfigureerd. Als de test mislukt, controleer dan de webhook-URL, de methode, het authenticatietype, de queryparameters of de verzoektekst en test de actie vervolgens opnieuw.

11. Klik vervolgens op ‘Opslaan en toevoegen’.
12. Ga verder met het aanpassen van de agent en publiceer deze vervolgens.

Volgende stappen

• Maak en pas agents aan in de agentbouwer
• Voer agents uit en bekijk de uitvoer in de agent-inbox
• Bekijk de geschatte kredietkosten bij het gebruik van agents