Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

BD-3443: Fix typo and update "Contact Card" to "contact card" #8042

Merged
merged 2 commits into from
Sep 9, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -19,16 +19,17 @@ Expand our creative capabilities by leveraging Movable Ink's Intelligent Creativ
| Requirement | Description |
|---|---|
| Movable Ink account | A Movable Ink account is required to take advantage of this partnership. |
| Data source | You will need to connect a data source to Movable Ink. This can be done through CSV, website import, or API. Make sure that you pass data with a unifying identifier between Braze and Movable Ink (for example, `external_id`).
| Data source | You'll need to connect a data source to Movable Ink. This can be done through CSV, website import, or API. Make sure that you pass data with a unifying identifier between Braze and Movable Ink (for example, `external_id`).
{: .reset-td-br-1 .reset-td-br-2}

## Use cases

- Personalized monthly or end-of-year recaps.
- Dynamically personalize images for email, push, or rich notifications based on last known behavior.<br>
For Example:
- Using a rich push message to dynamically create a schedule of events by pulling data from API.
- Using the Countdown Timer feature to notify users when a big sale is approaching (for example, Black Friday, Valentine's Day, Holiday Deals, etc.)
- Use the Scratch Off feature as a fun and interactive way to disburse Promo Codes.
- Using the countdown timer to notify users when a big sale is approaching (for example, Black Friday, Valentine's Day, or holiday deals)
- Use the Scratch Off feature as a fun and interactive way to disburse promotion codes.

## Supported Movable Ink capabilities

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ search_tag: Partner
| Data source | You need to connect a data source to Movable Ink. This can be done through CSV, website import, or API. |
| MMS sending capabilities | Confirm that you're set up for MMS through Braze.
| [Link shortening]({{site.baseurl}}/user_guide/message_building_by_channel/sms/campaign/link_shortening/) | Confirm that link shortening is turned on. |
| Contact Card | Your brand (the sender) must be saved as a contact on the user's phone for link preview to work with iOS. This can be done with a contact card or another method. |
| Contact card | Your brand (the sender) must be saved as a contact on the user's phone for link preview to work with iOS. This can be done with a contact card or another method. |
{: .reset-td-br-1 .reset-td-br-2}

## Integration
Expand All @@ -31,9 +31,9 @@ Follow the respective steps below to send dynamic SMS links for iOS and Android
To allow link preview images for iOS, users must add your brand (the sender) as a contact.
{% endalert %}

#### Step 1: Create a Contact Card campaign
#### Step 1: Create a contact card campaign

After users save your brand as a contact, either through a Braze [content card]({{site.baseurl}}/user_guide/message_building_by_channel/sms/mms/contact_card/) or another method, they will be able to view **Tap to Load Preview** prompts and Movable Ink links.
After users save your brand as a contact, either through a [contact card]({{site.baseurl}}/user_guide/message_building_by_channel/sms/mms/contact_card/) or another method, they will be able to view **Tap to Load Preview** prompts and Movable Ink links.

![1]{: style="max-width:30%;"}

Expand All @@ -59,13 +59,15 @@ After users load the link preview, a personalized image will render with the abi

![4]{: style="max-width:30%;"}

### Android (Google & Samsung devices)
### Android (Google and Samsung devices)

Android users aren't required to save your brand as a contact in order to receive dynamic SMS link previews. However, it is still recommended so that the device can automatically load the link previews.

![5]{: style="max-width:30%;"}

Users who haven't saved your brand as a contact and have turned on automatic previews will have to select **Tap to load preview** to load the preiew image. <br>![6]{: style="max-width:30%;"}
Users who haven't saved your brand as a contact and have turned on automatic previews will have to select **Tap to load preview** to load the preview image.

![6]{: style="max-width:30%;"}

## Considerations

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -76,9 +76,9 @@ Need help creating awesome copy? Try using the [AI copywriting assistant]({{site

![Launch AI Copywriter button, located in the Message field of the SMS composer.]({% image_buster /assets/img/ai_copywriter/ai_copywriter_sms.png %}){: style="max-width:60%"}

### Contact Cards
### Contact cards

If desired, you can add a Contact Card to your SMS message to make it easy for your customers to add your business and contact information to their contacts. You can assign common properties to these cards, such as your company's name, phone number, address, email, and a small photo. Check out [Contact Cards]({{site.baseurl}}/user_guide/message_building_by_channel/sms/mms/contact_card/) to learn more.
If desired, you can add a contact card to your SMS message to make it easy for your customers to add your business and contact information to their contacts. You can assign common properties to these cards, such as your company's name, phone number, address, email, and a small photo. Check out [Contact cards]({{site.baseurl}}/user_guide/message_building_by_channel/sms/mms/contact_card/) to learn more.

## Step 3: Preview and test your message

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,55 +2,55 @@
nav_title: Contact Cards
article_title: Contact Cards
page_order: 3
description: "This reference article covers how to create a Contact Card to include in your MMS and SMS messages."
description: "This reference article covers how to create a contact card to include in your MMS and SMS messages."
page_type: reference
channel:
- MMS

---

# Contact Cards
# Contact cards

> Contact Cards (sometimes known as vCard or Virtual Contact Files (VCF)) are a standardized file format for sending business and contact information that can be easily imported into address books or contact books.
> Contact cards (sometimes known as vCard or Virtual Contact Files (VCF)) are a standardized file format for sending business and contact information that can be easily imported into address books or contact books.

Contact Cards can be created [programmatically](https://www.twilio.com/blog/send-vcard-twilio-sms) and uploaded to the Braze [media library]({{site.baseurl}}/user_guide/engagement_tools/templates_and_media/media_library/#media-library) or created through our built-in Contact Card Generator. These cards can be assigned common properties such as your company's name, phone number, address, email, and a small photo. To start making Contact Cards, first make sure you're set up to use MMS in Braze.
Contact cards can be created [programmatically](https://www.twilio.com/blog/send-vcard-twilio-sms) and uploaded to the Braze [media library]({{site.baseurl}}/user_guide/engagement_tools/templates_and_media/media_library/#media-library) or created through our built-in contact card generator. These cards can be assigned common properties such as your company's name, phone number, address, email, and a small photo. To start making contact cards, first make sure you're set up to use MMS in Braze.

## Contact Card generator
## Contact card generator

<script src="https://fast.wistia.com/embed/medias/7m77mdfr4y.jsonp" async></script><script src="https://fast.wistia.com/assets/external/E-v1.js" async></script><div class="wistia_responsive_padding" style="padding:56.25% 0 0 0;position:relative;"><div class="wistia_responsive_wrapper" style="height:100%;left:0;position:absolute;top:0;width:100%;"><div class="wistia_embed wistia_async_7m77mdfr4y videoFoam=true" style="height:100%;position:relative;width:100%"><div class="wistia_swatch" style="height:100%;left:0;opacity:0;overflow:hidden;position:absolute;top:0;transition:opacity 200ms;width:100%;"><img src="https://fast.wistia.com/embed/medias/7m77mdfr4y/swatch" style="filter:blur(5px);height:100%;object-fit:contain;width:100%;" alt="" aria-hidden="true" onload="this.parentNode.style.opacity=1;" /></div></div></div></div>

### Step 1: Assign name

Contact Cards can be created from the SMS and MMS composer. Select the **Contact Card Generator** tab to get started.
Contact cards can be created from the SMS and MMS composer. Select the **Contact Card Generator** tab to get started.

Next, you will be prompted to input your company name or nickname. This is the name that your users will see when they save the card. A 20-character limit is enforced to ensure the user can see your whole company name or alias in their contacts and messaging app.

![]({% image_buster /assets/img/sms/contact_card1.png %}){: style="max-width:60%" }

### Step 2: Assign phone number

Select the subscription group and desired phone number from the available dropdown options. This number will be listed in your Contact Card and available on their phone to text to after it's saved.
Select the subscription group and desired phone number from the available dropdown options. This number will be listed in your contact card and available on their phone to text to after it's saved.

Note that alphanumeric codes are not compatible with two-way messaging and are not supported for Contact Cards.
Note that alphanumeric codes are not compatible with two-way messaging and are not supported for contact cards.

### Step 3: Optional fields

![]({% image_buster /assets/img/sms/contact_card2.png %}){: style="float:right;max-width:35%;margin-left:15px;"}

**Contact Card Contact Photo**<br>
You can upload an optional thumbnail contact photo for your Contact Card. We recommend a 240 x 240&nbsp;px JPEG or PNG image. Any high-resolution images uploaded will be resized to 240 x 240&nbsp;px to ensure the deliverability of your message, as MMS messages larger than 5&nbsp;MB may fail.
#### Upload contact card contact photo

**Other Information**<br>
Other fields allow you to insert your name, subheader, address, and other contact information that your user may want to have handy.
You can upload an optional thumbnail contact photo for your contact card. We recommend a 240 x 240&nbsp;px JPEG or PNG image. Any high-resolution images uploaded will be resized to 240 x 240&nbsp;px to ensure the deliverability of your message, as MMS messages larger than 5&nbsp;MB may fail.

<br>
#### Add more information

Other fields allow you to insert your name, subheader, address, and other contact information that your user may want to have available.

### Step 4: Saving your contact card

Once you've input all the necessary fields, click **Generate Contact Card**, and it will be automatically attached to your campaign or Canvas. From here, you can add a message, test your Contact Card, and launch your campaign or Canvas.
Once you've input all the necessary fields, click **Generate Contact Card**, and it will be automatically attached to your campaign or Canvas. From here, you can add a message, test your contact card, and launch your campaign or Canvas.

The Contact card will also be saved in the [media library]({{site.baseurl}}/user_guide/engagement_tools/templates_and_media/media_library/#media-library) to easily reuse in future campaigns and Canvases.
The contact card will also be saved in the [media library]({{site.baseurl}}/user_guide/engagement_tools/templates_and_media/media_library/#media-library) to easily reuse in future campaigns and Canvases.

## Adding an existing contact card

To add an existing Contact Card, create a campaign or Canvas and select your desired subscription group. Next, an **Add Media** option will appear in the message composer window. Here, you can upload an existing Contact Card file or locate one through the media library.
To add an existing contact card, create a campaign or Canvas and select your desired subscription group. Next, an **Add Media** option will appear in the message composer window. Here, you can upload an existing contact card file or locate one through the media library.
37 changes: 19 additions & 18 deletions _docs/_user_guide/message_building_by_channel/sms/mms/create.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,39 +11,40 @@ channel:
search_rank: 1
---

# Creating an MMS Campaign
# Creating an MMS campaign

> This page only contains information specific to MMS composition, which is part of the SMS composer. For more detailed information about the SMS/MMS composer, check the [SMS Composer][1].
> This article contains information specific to MMS composition, which is part of the SMS composer. For more detailed information about the SMS/MMS composer, check the [SMS Composer][1].

## MMS sending basics

Sending MMS with Braze:
### Select your subscription group

- **Select your subscription group**
- You must designate a subscription group with MMS enabled phone numbers to target (can be short or long codes).<br><br>
- **Input message body**
- Input PNG, JPEG, GIF, and VCF image types from the media library or specify a URL.
- Only 1 image supported<br><br>
- **Understand MMS sending**
- MMS are billed at a different rate versus text-only SMS.
- Not all carriers can accept MMS. In these cases, Twilio will automatically convert the MMS to an image link the user can click.
You must designate a subscription group with MMS enabled phone numbers to target (can be short or long codes).

### Contact Cards
### Input message body

Contact Cards (sometimes known as vCard or Virtual Contact Files (vcf)) are a standardized file format for sending business and contact information that can be easily imported into address books or contact books. These cards can be created [programmatically](https://www.twilio.com/blog/send-vcard-twilio-sms) and uploaded to the Braze media library or created through our built-in [Contact Card generator]({{site.baseurl}}/user_guide/message_building_by_channel/sms/mms/contact_card/).
Input PNG, JPEG, GIF, and VCF image types from the media library or specify a URL. Only one image is supported.

### Understand MMS sending

MMS are billed at a different rate versus text-only SMS, and not all carriers can accept MMS. In these cases, Twilio will automatically convert the MMS to an image link the user can click.

### Use contact cards

Contact cards (sometimes known as vCard or Virtual Contact Files (vcf)) are a standardized file format for sending business and contact information that can be easily imported into address books or contact books. These cards can be created [programmatically](https://www.twilio.com/blog/send-vcard-twilio-sms) and uploaded to the Braze media library or created through our built-in [contact card generator]({{site.baseurl}}/user_guide/message_building_by_channel/sms/mms/contact_card/).

## Creating an MMS message

Creating an MMS message requires your subscription group to be configured for MMS sending. This is indicated by seeing the MMS tag when selecting a subscription group. Upon selecting an MMS-enabled subscription group, you will have the ability to upload an image, reference an image URL, or include a Contact Card.
Creating an MMS message requires your subscription group to be configured for MMS sending. This is indicated by seeing the MMS tag when selecting a subscription group. Upon selecting an MMS-enabled subscription group, you will have the ability to upload an image, reference an image URL, or include a contact card.

![][2]

### Image specifications

**Image Specifications** | **Recommended Properties**
--- | ---
Size | 600&nbsp;KB maximum
File Types | PNG, JPEG, GIF
| **Image Specifications** | **Recommended Properties** |
|--------------------------|----------------------------|
| Size | 600&nbsp;KB maximum |
| File Types | PNG, JPEG, GIF |
{: .reset-td-br-1 .reset-td-br-2}

## Previewing an MMS message
Expand Down