アクセストークンの寿命

Twilio access tokens have a lifetime determined by your server when you generate the token, with a minimum of 3 minutes and maximum of 24 hours. When an access token in your application expires, you must update the token with your client(s) to continue using Twilio.

Twilio Client SDKs such as Chat and Sync take an access token as part of their initial parameters. They also offer a method to provide updated tokens over the lifetime of the client. For uninterrupted access to Twilio's services, you should provide renewed tokens to your Twilio client SDKs before expiration with the client's updateToken method.

Twilio offers an optional helper, AccessManager, to manage this renewal process. The usage of this helper is:

Implement AccessManager's facility to be notified of tokens that have already expired or are about to.

Provide AccessManager with a copy of a token in use by one or more Twilio clients.

Instruct AccessManager how to update your client with a callback that will be called with a new token.

When a token is in its final three minutes, the token will expire method is called. If the token was not updated before its expiry, a token expired method will trigger. You should use this method to get a new access token and set it on the AccessManager, making sure to update the token. AccessManager will then trigger the update you provided and set a timer based on the new token's expire time.

The implementation of this varies by platform and is described in detail below.

Your access token is passed to both AccessManager and your Twilio client(s). You also provide a block of code or method body to call upon token updates.

You should initialize both Access Manager and the Chat client with the same initial token. You can then either register an update lambda or implement a listener method depending on your platform. If you are using multiple Twilio client SDKs in your project that share a common access token with multiple service grants, you can register multiple update blocks here to renew each client.

AccessManager will trigger an event three minutes before token expiry (on iOS, Android, and coming soon to JS) and at the time of token expiration. It is best to implement only one of these methods. A token error event may surface if there is a problem with the token provided to AccessManager.

If a token is used with less than three minutes remaining until expiry, the token expiring mechanism will be called immediately. If the token is already expired, the token-expiring call, as well as the "token expired" call, will trigger in that order.