Calling Errors

class pywa.errors.CallingError

Bases: WhatsAppError

Base exception for all calling errors.

• Read more at developers.facebook.com.

class pywa.errors.CallingNotEnabled

Bases: CallingError

Calling is not enabled on the business phone number.

Configure call settings to enable Calling API features.

class pywa.errors.CallingCannotBeEnabled

Bases: CallingError

WhatsApp Business calling cannot be enabled because technical pre-requisites are not met.

See prerequisites for more details

Configure SIP or ensure there is at-least one app subscribed to the WhatsApp Business Account that also has subscription to the calls webhook field.

class pywa.errors.ReceiverUncallable

Bases: CallingError

Receiver is unable to receive calls

Reasons can include:

• The recipient phone number is not a WhatsApp phone number.

• The recipient has not accepted our new Terms of Service and Privacy Policy.

• Recipient using an unsupported client. The currently supported clients are Android, iOS, SMB Android and SMB iOS

Confirm with the recipient that they agree to be contacted by you over WhatsApp and are using the latest version of WhatsApp.

class pywa.errors.ConcurrentCallsLimit

Bases: CallingError

Limit reached for maximum concurrent calls (1000) for the given number

Try again later or reduce the frequency or amount of API calls the app is making.

class pywa.errors.DuplicateCall

Bases: CallingError

A call is already ongoing with the receiver

Try again later when the current call ends.

class pywa.errors.CallConnectionError

Bases: CallingError

Error while connecting the call

Try again later or investigate the connection params provided to the API.

class pywa.errors.CallRateLimitExceeded

Bases: CallingError

Limit reached for maximum calls that can be initiated by the business phone number

Try again later or reduce the frequency or amount of API calls the app is making.

class pywa.errors.CallPermissionNotFound

Bases: CallingError

No approved call permission from the recipient

Ensure a call permission has been accepted by the consumer

class pywa.errors.CallConnectionTimeout

Bases: CallingError

Call was unable to connect due to a timeout

Business did not apply the offer/answer SDP from Cloud API in time. Connect API was not invoked with the answer SDP in time

class pywa.errors.CallPermissionRequestLimitHit

Bases: CallingError

Limit reached for call permission request sends for the given business and consumer pair

When a business sends more than the limit of call permission requests per time period, Call Permission Requests are rate limited. A connected call with a consumer will reset the limits.

class pywa.errors.BusinessInitiatedCallsLimitHit

Bases: CallingError

Limit reached for maximum business initiated calls allowed in 24 hours. Currently 5 connected business initiated calls are allowed within 24 hours.

Exact error details will be listed in the error_data section of the response payload. Details will include a timestamp when the next call is allowed.

class pywa.errors.FetchCallPermissionLimitHit

Bases: CallingError

Limit reached for requests to the fetch call permission status API.

Try again later or reduce the frequency or amount of requests to the API the app is making.