When adding candidates for a call, various errors may occur related to client IDs, missing phone number or incorrect data. This article discusses the most common problems and how to solve them.
The error occurs if:
When a Error occurs, the candidate field is highlighted in red.
To resolve the error, check if the specified parameters of the call candidate are correct and add it again.
An error occurs when clientExternalId matches within the same job:
{
"timestamp": 1725274879,
"type": "AlephTools\\DDD\\Common\\Model\\Exceptions\\InvalidArgumentException",
"error": "Cannot add candidates with the same client external id",
"details": null,
"request_id": "00000000000000000000000000000000",
"trace_id": null
}
To resolve the error, verify that the clientExternalId is correct.
Error occurs if clientExternalId is longer than 200 characters:
{
"timestamp": 1725274941,
"type": "AlephTools\\DDD\\Common\\Model\\Exceptions\\InvalidArgumentException",
"error": "Client external ID too long. Maximum length is 200.",
"details": null,
"request_id": "00000000000000000000000000000000",
"trace_id": null
}
To resolve the error, check that the clientExternalId parameter is not longer than 200 characters.
An error occurs if the candidate phone number was not passed in the request:
{
"timestamp": 1725274968,
"type": "AlephTools\\DDD\\Common\\Model\\Exceptions\\InvalidArgumentException",
"error": "Phone cannot be empty",
"details": null,
"request_id": "00000000000000000000000000000000",
"trace_id": null
}
The phone field must not be empty. To resolve the error, make sure that the phone number is passed in the request.
The error occurs if the candidate's phone number is specified incorrectly or an empty string is specified when the Enable Number Validation switch of the call job is enabled:
{
syncError: "No phone numbers found to call. Candidate skipped"
}
In this case, the candidate will be created with an error. To resolve the error, verify that the client's phone number is correct and add the candidate again.
An error occurs when trying to add a candidate to a stopped job:
{
"timestamp": 1725275034,
"type": "AlephTools\\DDD\\Common\\Model\\Exceptions\\InvalidStateException",
"error": "It is not possible to add a candidate to a auto call with the status HALTED[AutoCallId:00000000-0000-0000-0000-000000000000]",
"details": null,
"request_id": "00000000000000000000000000000000",
"trace_id": null
}
An error occurs when attempting to add a candidate to a failed job:
{
"timestamp": 1725275034,
"type": "AlephTools\\DDD\\Common\\Model\\Exceptions\\InvalidStateException",
"error": "It is not possible to add a candidate to a auto call with the status TIMEOUT[AutoCallId:00000000-0000-0000-0000-000000000000]",
"details": null,
"request_id": "00000000000000000000000000000000",
"trace_id": null
}
An error occurs when attempting to add a candidate to a locked job, for example:
{
"timestamp": 1725275096,
"type": "Illuminate\\Validation\\ValidationException",
"error": "Adding candidates blocked. Reason: OUTDATED",
"details": [
[
"Adding candidates blocked. Reason: OUTDATED"
]
],
"request_id": "00000000000000000000000000000000",
"trace_id": null
}
Reasons for blocking: