working with The Campaign Registry directly. hideInGuideShowcase: true # Campaign Registry - Campaign Service Providers ## What is a CSP? :::warning Do I need to be a CSP? If you intend to only create a few Brands and Campaigns then you may choose to have SignalWire act as your CSP and submit your Messaging Campaign Applications on your behalf. If this describes your messaging intentions then you can learn about registering your Brand and Campaigns [**here**](../registration/index.mdx). ::: Before digging too deep into acronyms and terms about The Campaign Registry, please reference the [Campaign Registry - Everything You Need to Know](../campaign-registry-all-you-need-to-know.mdx) guide for more background on the policies put into place for 10 Digit Long Code Messaging. As an ISV (Independent Software Vendor), you have a customer base that each needs their own unique Brand and Campaign registration. As organizing your campaigns becomes increasingly complex, it may be time to look into managing your own campaigns by communicating with The Campaign Registry directly. A Campaign Service Provider has the ability to register or modify their own Brands and Campaigns without needing to involve SignalWire until it is time to associate the newly registered Brands and Campaigns. ## How to become a CSP and Getting Started The first step in becoming a Campaign Service Provider will be to [Register with The Campaign Registry](https://csp.campaignregistry.com/register) Next, you will need to Create a Brand within the Campaign Registry CSP Portal. The initial step for Campaign Registration will be to create a Brand. The information entered will be submitted for Brand Identity Verification so it is important that each field is correctly filled out. This will save time and also save you from pulling your hair out later. After creating a Brand, you will need to Create a Campaign. A Campaign is a specific use case of your Brand that gives more information on the content that is being sent. Although the creation of a Brand and Campaign can be done through the CSP Campaign Registry Portal, you are also able to automate this process through the usage of the [Campaign Registry APIs](https://csp-api.campaignregistry.com/v2/restAPI). These REST APIs can be easily incorporated into whatever environment your system is based in. ## Associating your Brand and Campaigns with SignalWire Once you have created your Brands and Campaigns via The Campaign Registry Dashboard or API, first you must select SignalWire as your upstream Connectivity Partner (CNP), and then you must send Brand and Campaign information directly to SignalWire so your phone numbers can be connected to the newly registered Campaigns. In summary, you provide specific information about the new Brand and Campaign either via Dashboard or API, we review and accept the connection request, and then our upstream Direct Connect Aggregator (DCA) vets and accepts the connection request. Once the DCA election is completed, you may begin assigning your SignalWire phone numbers to your new Campaign! ### Associating your Brand and Campaigns with SignalWire via Dashboard If you choose to do this through the Dashboard, you can navigate to **Messaging Campaigns** and then **Create a partner brand**. After entering in your _name_ and _CSP brand reference_ via API or Dashboard, you will see your Partner Brand appear in the Dashboard. .default})
.default})
.default})
.default})
After associating your Brands, you must [Create Self-Registered Campaigns](/rest/signalwire-rest/endpoints/space/create-campaign) underneath the Brands that you have created. Again, this can be done via API through the usage of REST APIs, or, can be done through the SignalWire Dashboard underneath the **Messaging Campaigns** tab. .default})
.default})
.default})
.default})
For the final step, you must [Create a Phone Number Assignment](/rest/signalwire-rest/endpoints/space/create-order) to associate your Self-Registered Campaign to your SignalWire Phone number. Navigate to the _Campaign Phone Numbers_ section of the _Messaging Campaigns_ tab in your Dashboard to manually complete this process, or use our [REST API](/rest/signalwire-rest/endpoints/space/create-order). .default})
.default})
.default})
Please note that if the Brand and Campaign are not loaded into your SignalWire Space, phone numbers will not be able to associate with the Campaign and you will not be able to send messages. ### Associating Your Brand and Campaigns with SignalWire via API If you prefer to use the REST API to link your Brands and Campaigns with SignalWire, follow these detailed steps: 1. **Create a Brand via API** - **Endpoint**: [Create Brand](/rest/signalwire-rest/endpoints/space/create-brand) - **Method**: POST - **Required Fields**: - name: The name of your Brand. - csp_brand_reference: The approved Brand ID you received from The Campaign Registry. - csp_self_registered: Set this field to true to indicate that this Brand is self-registered.
2. **Create a Campaign via API** - **Endpoint**: [Create Campaign](/rest/signalwire-rest/endpoints/space/create-campaign) - **Method**: POST - **Required Fields**: - name: The name of your Campaign. - csp_campaign_reference: The approved Campaign ID from The Campaign Registry.
3. **Share Campaign with SignalWire via API** - **TCR API Documentation**: [TCR API - Share Campaign](https://csp-api.campaignregistry.com/v2/restAPI) - **Method**: PUT - **Endpoint**: /campaign/{campaignId}/sharing/{upstreamCnpId} - **Parameters**: - Replace {campaignId} with the 7-character Campaign ID (e.g., CXXXXXX). - Replace {upstreamCnpId} with SignalWire’s CSP ID (SYU5YT8).
4. **Create a Phone Number Assignment** - **Endpoint**: [Create Phone Number Assignment](/rest/signalwire-rest/endpoints/space/create-order) - **Method**: POST - **Required Fields**: - phone_numbers: A list of phone numbers to be assigned to the Campaign. #### Additional Information - **API Documentation**: Consult the linked API documentation for detailed guidelines on using these endpoints effectively. - **Error Handling**: Ensure you handle possible errors and responses from API calls to troubleshoot any issues during the setup process. By following these steps, you can seamlessly integrate your Brands and Campaigns with SignalWire via the REST API. For more detailed guidance or support, please refer to the linked documentation. ## DCA Election: The Final Step You, like many others, may think that you should be able to start sending messages immediately upon Campaign registration. However, something commonly overlooked is the fact that The Campaign Registry is simply a registration database that contains information for entities (such as mobile operators, DCA’s, CNP’s, and CSP’s) to reference. What this means is that the information your customers provide in their Campaign registration will need to be validated and vetted. Since you can realistically input anything in a Campaign registration, it’s not only our duty (and the DCA’s duty) to ensure that each and every registration follows [CTIA guidelines](https://www.ctia.org/the-wireless-industry/industry-commitments/messaging-interoperability-sms-mms), but it is the duty of you as the ISV (Independent Software Vendor) to vet your own customers and the information they provide for the registrations. You should know that our DCA is pretty strict with what they will and won’t allow on their platform. Their vetting practices are thorough, and we recommend that you take a look at our guide for [Upstream Campaign Vetting](https://signalwire.com/blogs/industry/campaign-vetting-tips-for-tcr). We also suggest reviewing our list of [Explicitly Prohibited Content](/guides/sms-best-practices-how-to-ensure-message-delivery#explicitly-prohibited-content) to ensure your customers’ use cases will be able to send messages through our platform. DCA election can take an additional 24 hours or more after you initially connect your Campaign to your SignalWire Space. The sooner you load your Campaign into your Space, the better. SignalWire will not request DCA election until after we have been alerted that a new Campaign needs to be connected, and the Campaign has been loaded into the SignalWire Space. During DCA election vetting, the DCA will be checking to ensure there is a valid website that showcases who exactly is sending messages, the quality of the registration itself, and if the registration follows [CTIA guidelines](https://www.ctia.org/the-wireless-industry/industry-commitments/messaging-interoperability-sms-mms). Rejections can occur if insufficient information has been provided, and a resubmission fee of $7.50 will be applied upon resubmission. ## The Campaign Registry Fees The movement to prevent unwanted messaging content involves a lot of engineering power and is quite costly. This pushes some of the cost down to the individual CSPs, as broken down in the table below. Luckily, SignalWire understands that these fees are enough of a burden for you, and we do not add on any other costs to associate with us. All of these fees will be handled between you and The Campaign Registry. .default})