See Webhooks section to understand how Alcmeon delivers webhooks.

Whatsapp 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	Possible values	Type
status	delivered	str
message_id	A unique ID representing the message sent	str
time	The time of the event	str

Example:

{
  "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	Possible values	Type
status	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	Possible values	Type
code	Whatsapp error code See the full list here	str
errorText	Description of the error	str

Example:

{
  "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 webhooks

If you are using the Kakotalk 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 Kakaotalk.

Field	Possible values	Type
status	delivered	str
message_id	A unique ID representing the message sent	str
time	The time of the event	str

Example:

{
  "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	Possible values	Type
status	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	Possible values	Type
code	See error code section	str
errorText	Description of the error	str

Example:

{
  "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)