Webhooks
A Aivyro avisa o seu HTTPS quando o CRM ou o inbox mudam. Sem polling.
Assine um endpoint HTTPS. A URL precisa ser HTTPS e não pode apontar para rede privada.
| HTTP | Path | Scope |
|---|---|---|
| GET | /api/v1/webhooks | rest.crm.webhooks.read |
| POST | /api/v1/webhooks | rest.crm.webhooks.write |
| GET | /api/v1/webhooks/{id} | rest.crm.webhooks.read |
| PATCH | /api/v1/webhooks/{id} | rest.crm.webhooks.write |
| DELETE | /api/v1/webhooks/{id} | rest.crm.webhooks.write |
| GET | /api/v1/webhooks/{id}/deliveries | rest.crm.webhooks.read |
| POST | /api/v1/webhooks/{id}/rotate_secret | rest.crm.webhooks.write |
GET /api/v1/webhooks devolve um array JSON, não uma página de cursor. Workspace vazio: []. signing_secret aparece só no create e no rotate.
Campos
| Campo | Tipo | Notas |
|---|---|---|
| id | UUID | Imutável. |
| url | string | HTTPS. Sem rede privada. |
| events | string[] | Pelo menos um no create. |
| active | boolean | PATCH para pausar. |
| signing_secret | string | Só no create e rotate. |