# How to work with Enate's Webhooks

In order to work with Webhooks in Enate, you need to pass certain parameters to the Webhook (see [here ](/enate-help/integrations/enate-integrations/webhooks/enates-webhooks.md#explanation-of-parameters-required)for more information) and you will get a message returned with corresponding information (see below for more information).

## Message Returned Explanation

| Message                 | Detail                                                                                                                                                                                                                                                                             |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| "**AttachmentCount**"   | This is the number of attachments on the communication                                                                                                                                                                                                                             |
| "**CC**"                | Email addresses included in the email 'CC' field                                                                                                                                                                                                                                   |
| "**CommunicationType**" | <p>The communication type used : </p><p>0 = EmailOutgoing</p><p>1 = PhoneIncoming </p><p>2 = EmailIncoming </p><p>3 = ESSComment </p><p>4 = AuditNote </p><p>5 = PhoneOutgoing</p><p>6 = LetterIncoming</p><p>7 = LetterOutgoing</p>                                               |
| "**ContractName**"      | The name of the contract                                                                                                                                                                                                                                                           |
| "**CustomerName**"      | The name of the customer                                                                                                                                                                                                                                                           |
| "**DueDate**"           | This is not set until the packet is submitted – newly created packets won’t have it yet                                                                                                                                                                                            |
| "**From**"              | 'From' email address if included in the email/message formats                                                                                                                                                                                                                      |
| **"GUID**"              | The Webhook GUID                                                                                                                                                                                                                                                                   |
| "**Name**"              | Name is set by the user                                                                                                                                                                                                                                                            |
| "**PacketGUID**"        | This identifies the packet which is being reported on, the GUID in the response when creating a new subscription is the identifier for hat subscription                                                                                                                            |
| "**ProcessType**"       | <p>The process type. </p><p>1 = Case</p><p>2 = Ticket</p><p>3 = Action</p>                                                                                                                                                                                                         |
| "**ProcessTypeName**"   | The name of the process type                                                                                                                                                                                                                                                       |
| "**RAGStatus**"         | <p>The RAG status of the packet. </p><p>-2 = ToBeDetermined</p><p>-1 = Overdue</p><p>0 = DueToday</p><p>1 = DueInFuture</p>                                                                                                                                                        |
| "**Reference**"         | This is a system-generated identifier for a packet, it follows Enate’s own formatting                                                                                                                                                                                              |
| "**Sender**"            | The email address of the sender                                                                                                                                                                                                                                                    |
| "**ServiceName**"       | The name of the service                                                                                                                                                                                                                                                            |
| "**ServiceLineName**"   | The name of the service line                                                                                                                                                                                                                                                       |
| "**StartedbyMethod**"   | <p>The method by which the packet was started. </p><p>0 = Workflow </p><p>1 = ByOperationalUser</p><p>2 = BySelfServiceUser </p><p>3 = ByRobotUser </p><p>4 = ByEmail</p><p>5 = FromTicket </p><p>6 = ByOperationalUserInBulk</p><p>7 = ByRobotUserInBulk</p><p>8 = BySchedule</p> |
| "**Status**"            | <p>The status of the packet. </p><p>0 = Draft</p><p>1 = To Do</p><p>2 = In Progress</p><p>3 = Waiting</p><p>4 = Resolved</p><p>5 = Closed</p>                                                                                                                                      |
| "**Subject**"           | This is the pulled from the subject field of the communication, if it has one                                                                                                                                                                                                      |
| "**SupplierName**"      | The name of the supplier                                                                                                                                                                                                                                                           |
| "**Title**"             | The title of the packet. This is not set until the packet is submitted when it is set by the user (or whatever is creating the packet) – newly created packets won’t have it yet                                                                                                   |

## Parameters Required Explanation

| Parameter               | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **"CustomHeader"**      | Optional field which adds a custom header to all messages sent by the Webhook subscription – it can be used, for example, to include additional authentication information to ensure incoming messages are genuine, or to enrich incoming messages to make them easier to identify and process.                                                                                                                                                                                                                                                                                                                               |
| **"CustomHeaderValue"** | Optional field which adds a corresponding value to the custom header to all messages sent by the Webhook subscription – it can be used, for example, to include additional authentication information to ensure incoming messages are genuine, or to enrich incoming messages to make them easier to identify and process.                                                                                                                                                                                                                                                                                                    |
| "**FilterObjectGUID**"  | <p>Mandatory field, identifying GUID for whatever object type (FilterObjectType) is required. </p><ul><li>For <a href="/pages/-MWn_f2d81yx3BuUIz8D#packet-created">PacketCreated </a>the FilterObjectType can be either Company, Contract or Service.</li><li>For <a href="/pages/-MWn_f2d81yx3BuUIz8D#businessobjectcreated">BusinessObjectCreated</a> it can be either Schedule or Company</li><li>For <a href="/pages/-MWn_f2d81yx3BuUIz8D#packet-updated">PacketUpdated </a>or <a href="/pages/-MWn_f2d81yx3BuUIz8D#newcommunication">NewCommunication </a>it can only be a Packet (Case/Ticket Process)</li></ul><p></p> |
| "**FilterObjectType**"  | <p>ID for the type of object being filtered by. Company = 31</p><p>Contract = 215</p><p>Service = 217</p><p>Process = 911</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| "**SubscriberURL**"     | A valid URL (inc. http/https") which can receive the WebHook message                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| "**Webhook**"           | Name of the WebHook being subscribed to i.e. PacketCreated                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

## Note on creating Webhook subscriptions:

For creating subscriptions, the FilterObjectType and the FilterObjectGUID should match up according to the item you want to receive messages about, i.e. if you want to know about **Packets Created** for a particular **Company** then you would use:

* FilterObjectType = 31 (Company in the EnateObjects enum) (Or alternatively Contract = 215, Service = 217)
* FilterObjectGUID = \<any valid Company GUID you can access>
* WebHook = PacketCreated


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.enate.net/enate-help/integrations/enate-integrations/webhooks/enates-webhooks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
