Webhookit ilmoittavat sovelluksellesi, kun entiteettejä luodaan, päivitetään tai poistetaan Mokapenissa. Käytä niitä tapahtumalähtöisiin integraatioihin REST-sovellusliittymien kyselyn sijaan.
Rekisteröi webhookin URL-osoite ja valitse vastaanotettavat tapahtumat. Kun tapahtuma tapahtuu, Mokapen lähettää HTTP POST -pyynnön päätepisteellesi JSON-hyötykuormalla.
Webhook-hallinnan päätepisteet vaativat kelvollisen siirtotietunnuksen, jolla on asianmukaiset laajuudet.
GET /api/webhooks
POST /api/webhooks
PUT /api/webhooks/{webhook_id}
DELETE /api/webhooks/{webhook_id}
GET /api/webhooks/{webhook_id}/logs
GET /api/webhook-events
Lähetä POST, jossa on takaisinsoitto-URL-osoite, organisaatiotunnus ja valitut tapahtumat:
POST /api/webhooks
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json
{
"url": "https://example.com/webhooks/mokapen",
"org_id": 849,
"events": ["task.created", "task.updated", "contact.created"]
}
Tarkista saapuvat webhook-pyynnöt palvelimeltasi. Käytä vain HTTPS-päätepisteitä. Säilytä salaisuudet turvallisesti ja vahvista hyötykuormat ennen niiden käsittelyä.
Tallentamalla webhookin voit tilata yhden tai useamman seuraavista tapahtumista:
task.createdtask.updatedtask.deletedproject.createdproject.updatedproject.deletedcontact.createdcontact.updatedcontact.deletedcompany.createdcompany.updatedcompany.deletedticket.createdticket.updatedticket.deletedbooking.createdbooking.updatedbooking.deletedproduct.createdproduct.updatedproduct.deletedservice.createdservice.updatedservice.deletedquote.createdquote.updatedquote.deletedorder.createdorder.updatedorder.deleteddeal.createddeal.updateddeal.deletedappointment.createdappointment.updatedappointment.deleteddocument.createddocument.updateddocument.deletedcampaign.createdcampaign.updatedcampaign.deletedTarvitsetko apua?