AWS API Changes

2026/10/19 - AWS End User Messaging Social - 3 updated api methods

Changes Adding support for WhatsApp Direct Send.

GetLinkedWhatsAppBusinessAccount (updated)

Link ¶
Changes (response)

{'account': {'directSendEnforcementStatus': 'string',
             'directSendEnforcementStatusExpiresAt': 'timestamp'}}

Get the details of your linked WhatsApp Business Account.

See also: AWS API Documentation

Request Syntax

client.get_linked_whatsapp_business_account(
    id='string'
)

type id:

string

param id:

[REQUIRED]

The unique identifier, from Amazon Web Services, of the linked WhatsApp Business Account. WABA identifiers are formatted as waba-01234567890123456789012345678901. Use ListLinkedWhatsAppBusinessAccounts to list all WABAs and their details.

rtype:

dict

returns:

Response Syntax

{
    'account': {
        'arn': 'string',
        'id': 'string',
        'wabaId': 'string',
        'registrationStatus': 'COMPLETE'|'INCOMPLETE',
        'linkDate': datetime(2015, 1, 1),
        'wabaName': 'string',
        'eventDestinations': [
            {
                'eventDestinationArn': 'string',
                'roleArn': 'string'
            },
        ],
        'marketingMessagesOnboardingStatus': 'string',
        'directSendEnforcementStatus': 'string',
        'directSendEnforcementStatusExpiresAt': datetime(2015, 1, 1),
        'datasetId': 'string',
        'phoneNumbers': [
            {
                'arn': 'string',
                'phoneNumber': 'string',
                'phoneNumberId': 'string',
                'metaPhoneNumberId': 'string',
                'displayPhoneNumberName': 'string',
                'displayPhoneNumber': 'string',
                'qualityRating': 'string',
                'dataLocalizationRegion': 'string'
            },
        ]
    }
}

Response Structure

(dict) --
- account (dict) --
  
  The details of the linked WhatsApp Business Account.
  - arn (string) --
    
    The ARN of the linked WhatsApp Business Account.
  - id (string) --
    
    The ID of the linked WhatsApp Business Account, formatted as waba-01234567890123456789012345678901.
  - wabaId (string) --
    
    The WhatsApp Business Account ID from meta.
  - registrationStatus (string) --
    
    The registration status of the linked WhatsApp Business Account.
  - linkDate (datetime) --
    
    The date the WhatsApp Business Account was linked.
  - wabaName (string) --
    
    The name of the linked WhatsApp Business Account.
  - eventDestinations (list) --
    
    The event destinations for the linked WhatsApp Business Account.
    - (dict) --
      
      Contains information on the event destination.
      - eventDestinationArn (string) --
        
        The ARN of the event destination.
      - roleArn (string) --
        
        The Amazon Resource Name (ARN) of an Identity and Access Management role that is able to import phone numbers and write events.
  - marketingMessagesOnboardingStatus (string) --
    
    The onboarding status for the Marketing Messages API. This value is fetched from Meta and indicates whether the WhatsApp Business Account is onboarded for Meta's Marketing Messages API.
  - directSendEnforcementStatus (string) --
    
    The Direct Send enforcement status for the WhatsApp Business Account. Enforcement applies when an account repeatedly sends messages in a category that does not match the content. This field is not present when no enforcement is active.
  - directSendEnforcementStatusExpiresAt (datetime) --
    
    The time when the current Direct Send enforcement is expected to lift. This field is not present for permanent enforcement or when no enforcement is active.
  - datasetId (string) --
    
    The Meta Conversions API dataset ID associated with this WhatsApp Business Account. This value is a numeric string of 10 to 20 digits. This field is not present when no dataset has been created for this account.
  - phoneNumbers (list) --
    
    The phone numbers associated with the Linked WhatsApp Business Account.
    - (dict) --
      
      The details of a linked phone number.
      - arn (string) --
        
        The full Amazon Resource Name (ARN) for the phone number.
      - phoneNumber (string) --
        
        The phone number associated with the Linked WhatsApp Business Account.
      - phoneNumberId (string) --
        
        The phone number ID. Phone number identifiers are formatted as phone-number-id-01234567890123456789012345678901.
      - metaPhoneNumberId (string) --
        
        The phone number ID from Meta.
      - displayPhoneNumberName (string) --
        
        The display name for this phone number.
      - displayPhoneNumber (string) --
        
        The phone number that appears in the recipients display.
      - qualityRating (string) --
        
        The quality rating of the phone number. This is from Meta.
      - dataLocalizationRegion (string) --
        
        The geographic region where the WhatsApp phone number's data is stored and processed.

ListLinkedWhatsAppBusinessAccounts (updated)

Link ¶
Changes (response)

{'linkedAccounts': {'directSendEnforcementStatus': 'string',
                    'directSendEnforcementStatusExpiresAt': 'timestamp'}}

List all WhatsApp Business Accounts linked to your Amazon Web Services account.

See also: AWS API Documentation

Request Syntax

client.list_linked_whatsapp_business_accounts(
    nextToken='string',
    maxResults=123
)

type nextToken:

string

param nextToken:

The next token for pagination.

type maxResults:

integer

param maxResults:

The maximum number of results to return.

rtype:

dict

returns:

Response Syntax

{
    'linkedAccounts': [
        {
            'arn': 'string',
            'id': 'string',
            'wabaId': 'string',
            'registrationStatus': 'COMPLETE'|'INCOMPLETE',
            'linkDate': datetime(2015, 1, 1),
            'wabaName': 'string',
            'eventDestinations': [
                {
                    'eventDestinationArn': 'string',
                    'roleArn': 'string'
                },
            ],
            'marketingMessagesOnboardingStatus': 'string',
            'directSendEnforcementStatus': 'string',
            'directSendEnforcementStatusExpiresAt': datetime(2015, 1, 1),
            'datasetId': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

(dict) --
- linkedAccounts (list) --
  
  A list of WhatsApp Business Accounts linked to your Amazon Web Services account.
  - (dict) --
    
    The details of a linked WhatsApp Business Account.
    - arn (string) --
      
      The ARN of the linked WhatsApp Business Account.
    - id (string) --
      
      The ID of the linked WhatsApp Business Account, formatted as waba-01234567890123456789012345678901.
    - wabaId (string) --
      
      The WhatsApp Business Account ID provided by Meta.
    - registrationStatus (string) --
      
      The registration status of the linked WhatsApp Business Account.
    - linkDate (datetime) --
      
      The date the WhatsApp Business Account was linked.
    - wabaName (string) --
      
      The name of the linked WhatsApp Business Account.
    - eventDestinations (list) --
      
      The event destinations for the linked WhatsApp Business Account.
      - (dict) --
        
        Contains information on the event destination.
        
        eventDestinationArn (string) --
        
        The ARN of the event destination.
        
        roleArn (string) --
        
        The Amazon Resource Name (ARN) of an Identity and Access Management role that is able to import phone numbers and write events.
    - marketingMessagesOnboardingStatus (string) --
      
      The onboarding status for the Marketing Messages API. This value is fetched from Meta and indicates whether the WhatsApp Business Account is onboarded for Meta's Marketing Messages API.
    - directSendEnforcementStatus (string) --
      
      The Direct Send enforcement status for the WhatsApp Business Account. Enforcement applies when an account repeatedly sends messages in a category that does not match the content. This field is not present when no enforcement is active.
    - directSendEnforcementStatusExpiresAt (datetime) --
      
      The time when the current Direct Send enforcement is expected to lift. This field is not present for permanent enforcement or when no enforcement is active.
    - datasetId (string) --
      
      The Meta Conversions API dataset ID associated with this WhatsApp Business Account. This value is a numeric string of 10 to 20 digits. This field is not present when no dataset has been created for this account.
- nextToken (string) --
  
  The next token for pagination.

ListWhatsAppMessageTemplates (updated)

Link ¶
Changes (response)

{'templates': {'correctCategory': 'string', 'templateSource': 'string'}}

Lists WhatsApp message templates for a specific WhatsApp Business Account.

See also: AWS API Documentation

Request Syntax

client.list_whats_app_message_templates(
    id='string',
    nextToken='string',
    maxResults=123
)

type id:

string

param id:

[REQUIRED]

The ID of the WhatsApp Business Account to list templates for.

type nextToken:

string

param nextToken:

The token for the next page of results.

type maxResults:

integer

param maxResults:

The maximum number of results to return per page (1-100).

rtype:

dict

returns:

Response Syntax

{
    'templates': [
        {
            'templateName': 'string',
            'metaTemplateId': 'string',
            'templateStatus': 'string',
            'templateQualityScore': 'string',
            'templateLanguage': 'string',
            'templateCategory': 'string',
            'templateSource': 'string',
            'correctCategory': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

(dict) --
- templates (list) --
  
  A list of template summaries.
  - (dict) --
    
    Provides a summary of a WhatsApp message template's key attributes.
    - templateName (string) --
      
      The name of the template.
    - metaTemplateId (string) --
      
      The numeric ID assigned to the template by Meta.
    - templateStatus (string) --
      
      The current status of the template (for example, APPROVED, PENDING, or REJECTED).
    - templateQualityScore (string) --
      
      The quality score assigned to the template by Meta.
    - templateLanguage (string) --
      
      The language code of the template (for example, en_US).
    - templateCategory (string) --
      
      The category of the template (for example, UTILITY or MARKETING).
    - templateSource (string) --
      
      The source of the template. A value of AUTO_GENERATED indicates that the template was created automatically from a message that you sent. This field is not present for templates that you created manually.
    - correctCategory (string) --
      
      The category that the template content actually belongs to, when it differs from the template's current category. This field is present only when the template has been flagged as miscategorized.
- nextToken (string) --
  
  The token to retrieve the next page of results, if any.