Webhooks gebruiken in agents

Gebruik webhook-acties in agents om gegevens te verzenden naar en te ontvangen van externe systemen. Je kunt webhook-acties configureren in de agent-builder om HTTP-verzoeken te doen (bijvoorbeeld GET of POST), 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 overwegingen voordat u webhooks in agents gaat gebruiken.

• Een Super Admin moet de volgende schakelaars inschakelen in je 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 agent-builder 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 versturen van een melding of het bijwerken van een extern record.

Om een webhook-actie toe te voegen:

1. Ga in je HubSpot-account naar Agenten > Agent Hub.
2. Klik op het tabblad ‘Agents ’.
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 webhook-verzoektekst 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