---
updatedAt: 2025-11-26T20:08:30.000Z
agentTools:
projectIndex: https://developers.alcmeon.com/llms.txt
---
# Webhooks
See [Webhooks section](https://developers.alcmeon.com/docs/api-core-concepts#webhooks) to understand how Alcmeon delivers webhooks.
# Send Answer API
If you are using the Send Answer API you can configure a callback URL to be notified for statuses of the message you just sent.
The webhooks have the following format:
| Field | Description | Type |
| :---------- | :------------------------------------------------------------------ | :--- |
| input\_data | A dictionary containing information about the message you just sent | dict |
| status | Contains values "success" or "error" | str |
# Whatsapp Send API webhooks
If you are using the Whatsapp Send API you can configure a callback URL to be notified for statuses of the message you just sent.
You can receive 2 types of webhooks:
### Success webhook
Sent in case where Alcmeon received an asynchronous success webhook by Whatsapp.
| Field | Description | Type |
| :---------- | :---------------------------------------- | :--- |
| status | Contains value "delivered" | str |
| message\_id | A unique ID representing the message sent | str |
| time | The time of the event | str |
Example:
```json
{
"message_id": "11fde0ae-eb2a-4647-b723-831d67a6342c",
"status": "delivered",
"time": "2025-03-17 14:25:05.006537"
}
```
### Error webhook
Sent in case where Whatsapp answers with errors to the API call done to send the message or if Alcmeon received an asynchronous error webhook by Whatsapp.
| Field | Description | Type |
| :---------- | :---------------------------------------- | :--- |
| status | Contains value "failed" | str |
| message\_id | A unique ID representing the message sent | str |
| time | The time of the event | str |
| error | A dictionary containing error information | dict |
`error`
| Field | Description | Type |
| :-------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--- |
| code | Whatsapp error code See the full list here | str |
| errorText | Description of the error | str |
Example:
```json
{
"message_id": "e8f74e26-9fbc-4075-9570-03d6059daa33",
"time": "2025-03-14 15:45:49.249508+00:00",
"status": "failed",
"error": {
"code": 131026,
"errorText": "Unable to deliver message"
}
}
```
### Error codes
You can check the full list of error code on Meta's documentation. We use the same error codes.
# Kakaotalk Send Api webhooks
If you are using the [Kakotalk Send API](https://developers.alcmeon.com/reference/post_v1-kakaotalk-send) you can configure a callback URL to be notified for statuses of the message you just sent.
You can receive 2 types of webhooks:
### Success webhook
Sent in case where Alcmeon received an asynchronous success webhook by Kakaotalk.
| Field | Description | Type |
| :---------- | :---------------------------------------- | :--- |
| status | Contains value "delivered" | str |
| message\_id | A unique ID representing the message sent | str |
| time | The time of the event | str |
Example:
```json
{
"message_id": "11fde0ae-eb2a-4647-b723-831d67a6342c",
"status": "delivered",
"time": "2025-03-17 14:25:05.006537"
}
```
### Error webhook
Sent in case where Kakotalk answers with errors to the API call done to send the message or if Alcmeon received an asynchronous error webhook by Kakaotalk.
| Field | Description | Type |
| :---------- | :---------------------------------------- | :--- |
| status | Contains value "failed" | str |
| message\_id | A unique ID representing the message sent | str |
| time | The time of the event | str |
| error | A dictionary containing error information | dict |
error
| Field | Description | Type |
| :-------- | :--------------------------------------------------------------------------------- | :--- |
| code | See [error code](https://developers.alcmeon.com/page/webhooks#error-codes) section | str |
| errorText | Description of the error | str |
Example:
```json
{
"message_id": "e8f74e26-9fbc-4075-9570-03d6059daa33",
"time": "2025-03-14 15:45:49.249508+00:00",
"status": "failed",
"error": {
code: "3008",
errorText: "Invalid phone number"
}
}
```
### Error codes
| Code | Error description |
| :------------------ | :-------------------------------------------------------------------------------------------------------------------------- |
| A001 | Unauthorized accounts |
| A002 | Non-existent accounts |
| A003 | Accounts that are not eligible for MT Failover |
| A004 | Header with the authentication value ('X-IB-Client-Id'/'X-IB-Client-Passwd' or 'Authorization') missing |
| A005 | Invalid authentication token |
| A100 | If the response\_method value is null |
| A101 | Invalid response\_method value |
| A102 | senderKey is empty |
| A103 | Button's required name, type, is missing |
| A104 | Missing buttons |
| A105 | Invalid button type |
| A106 | Missing url\_mobile required for WL button type |
| A107 | Missing Scheme\_android required for AL button type |
| A108 | Missing Scheme\_ios required for AL button type |
| A109 | Missing sender |
| A110 | Missing recipients |
| A111 | Empty message content |
| A112 | Missing img\_url when using images |
| A113 | Missing msgType |
| A114 | Invalid msgType |
| A115 | Missing template code |
| A116 | Maximum message length exceeded |
| A117 | Maximum sender number length exceeded |
| A118 | Exceeding the maximum recipient number length |
| A119 | ad\_flag length exceeded |
| A120 | user\_key length exceeded |
| A121 | mt\_failover value error |
| A122 | MT Failover Message Length Limit Error |
| A123 | wide exceeds length |
| A124 | FriendTalk user\_key, to both missing |
| A125 | user\_id over length |
| A126 | app\_user\_id has no value |
| A127 | Neither "to" or "app\_user\_id" is present in the payload |
| A128 | user\_key has no value |
| A129 | (Customers using the Duplicate Shipment Check feature) Missing duplicate group code |
| A130 | (Customers using billing separation codes) Billing separation code length exceeded |
| A131 | Wide image is selected but the image is missing |
| A132 | Title length exceeded |
| A133 | Cannot enter content when using Brandtalk 'Fixed' type |
| A134 | Required failover\_content when using Brandtalk failover |
| A135 | Brandtalk request\_timeout required |
| A136 | MT Failover Message Subject Length Limit Error |
| A137 | MT Failover file key length limit error |
| A138 | ref length limit error |
| A139 | Brandtalk content\_type missing or too long |
| A140 | Brandtalk invalid content\_type |
| A141 | Brandtalk targeting length exceeded |
| A142 | Brandtalk invalid targeting |
| A143 | If you entered button field in Brandtalk 'Fixed' type |
| A144 | If you entered a variable field in a Brandtok 'Fixed' type |
| A145 | Brandtok 'Variable' type is missing a variable field |
| A146 | Brandtalk 'Variable' type mixed with specialized & variable separated fields |
| A147 | If you entered the name of the button field in the Brandtalk 'Variable' type |
| A148 | currency\_type over length |
| A149 | BF button \[Bizform key/Bizform ID] missing |
| A150 | If an image is missing from sending a friend's TikTok image/wide image |
| A151 | One-click checkout plugin (requires oneclick\_id or product\_id to be passed in the dispatch) |
| A152 | Header length exceeded |
| A153 | Missing title/subtitle information for an item |
| A154 | item's title/subtitle exceeds length |
| A155 | Failover\_type value error |
| A156 | failover\_rcs\_body missing |
| A157 | adult overlength |
| A158 | group\_tag\_key exceeds length |
| A159 | additional\_content overlength |
| A160 | push\_alarm length exceeded |
| A200 | Json format errors |
| A201 | Exceeding the number of shipments available |
| A999 | Unknown errors |
| 403 | Unauthorized access |
| 405 | Parameter error |
| 504 | Duplicate template code |
| 505 | Duplicate template name |
| 506 | Exceeded character limit |
| 507 | Invalid sender profile |
| 508 | Requested data not found |
| 509 | Unable to process request |
| 510 | Invalid template button format |
| 525 | Invalid template category |
| 512 | Unable to add sender profile group |
| 513 | Invalid message result reception channel |
| 514 | Business authentication required |
| 600 | Image upload failed |
| 610 | File upload failed |
| 611 | Template attachment too large |
| 612 | Invalid template attachment format |
| 613 | Too many template attachments |
| 614 | Attachment not found |
| 801/802/803/804/805 | Sender profile registration blocked |
| 811 | Sender profile registration blocked (hub partner) |
| 900 | Bizplus authentication key error |
| 901 | Bizplus API error |
| 902 | Kakao API communication error |
| 1001 | No JSON body |
| 1002 | Invalid hub partner key |
| 1003 | Invalid sender key |
| 1004 | No value JSON element |
| 1005 | Sender not found |
| 1006 | Deleted sender |
| 1007 | Stopped sender |
| 1011 | Contract not found |
| 1012 | Invalid user key |
| 1013 | Invalid app link |
| 1014 | Invalid business number |
| 1015 | Talk user ID not found |
| 1016 | Business number mismatch |
| 1020 | Invalid receiver user |
| 1021 | Blocked profile |
| 1022 | Deactivated profile |
| 1023 | Deleted profile |
| 1024 | Profile in deletion status |
| 1025 | Spammed profile |
| 1026 | Message type unavailable |
| 1030 | Invalid parameter |
| 1033 | Template and message type mismatch |
| 2000 | Failed to check friendship |
| 2003 | Message sending failed due to no friendship |
| 2004 | Template matching error |
| 2006 | Serial number format mismatch |
| 3000 | Unexpected error |
| 3005 | ACK timeout |
| 3006 | Message sending failure |
| 3008 | Invalid phone number |
| 3010 | JSON parsing error |
| 3011 | Message not found |
| 3012 | Duplicate serial number |
| 3013 | Message is empty |
| 3014 | Message length exceeds limit |
| 3015 | Template not found |
| 3016 | Template match error |
| 3018 | Message sending unavailable |
| 3020 | Seen info not found |
| 3022 | Message sending not available at this time. Friend Talk messages can be sent from 08:00 to 20:50 KST (Korea Standard Time) |
| 3023 | Invalid video in message |
| 3024 | Invalid image in message |
| 3025 | Variable length exceeded |
| 3026 | Invalid extra value in chat button |
| 3027 | Template button mismatch |
| 3028 | Template title mismatch |
| 3029 | Title length exceeded |
| 3030 | Message type-template mismatch |
| 3031 | Header mismatch with template |
| 3032 | Header length exceeded |
| 3033 | Item highlight mismatch |
| 3034 | Item highlight title length exceeded |
| 3035 | Item highlight description length exceeded |
| 3036 | Item list mismatch with template |
| 3037 | Item description length exceeded |
| 3038 | Item summary mismatch with template |
| 3039 | Item summary description length exceeded |
| 3040 | Invalid characters in item summary |
| 3041 | Wide item list length mismatch |
| 3046 | Additional content length exceeded |
| 3047 | Commerce title length exceeded |
| 3051 | Carousel item count minimum error |
| 3052 | Carousel message length exceeded |
| 3056 | Wide item list title length exceeded |
| 3058 | Carousel header length exceeded |
| 4000 | Response history not found |
| 4001 | Unknown message status |
| 5000 | Invalid test user |
| 5001 | Daily test limit exceeded |
| 7011 | Serial number pattern error |
| 7014 | Message validity timeout |
| 8512 | Recipient type not found |
| 8514 | Request ID not found |
| 8520 | Unsupported product type |
| 8521 | Unsupported message type |
| 8522 | Unsupported text type |
| 8523 | Unsupported response method |
| 8530 | Recipient list size error |
| 8999 | Internal server error |
| 9998 | Service unavailable |
| 9999 | Unknown system error |
| ME09 | Message is sent to user, but reception is not clear. (success is not clear / no payment) |