Updates: Check the release notes for new features and product updates.

Best practices

When you interact with Verified Calling, keep the following best practices in mind.

Update the state of every verified call

Verified Calls uses call state matching to secure registered calls. When you update the call state, Verified Calls matches the state the recipient's device reports to confirm that the call is coming from a verified source (you).

If you don't update the state of a registered call, a bad actor might spoof a call from your number, which would appear with your registered call information. Without state matching, Verified Calls and the recipient's phone wouldn't know that you hadn't placed the call yet and that the current caller wasn't genuine.

Implement retries with fixed delays

When calling any API, it's possible for a call to fail because of infrastructure issues, service overload, QPS limits, and myriad other errors. To recover from failed API calls gracefully, implement retries with fixed-time delays. Verified calls recommends delays of 5-10 seconds.

Using retries fixed time delays, your infrastructure automatically

  1. Identifies a failed API call
  2. Sets the wait duration and the maximum number of retries
  3. Pauses for the wait duration
  4. Retries the API call
  5. Assesses the API call response:

    • If a success, proceeds with next step in the workflow
    • If a failure, returns to step 3
    • If a failure after the maximum number of retries, enters a fail state