Skip to main content
Siga este guia para fazer seu primeiro disparo de campanha RCS via API.

​
Passo 1: Gerar Credenciais

Acesse o Dashboard > Configurações > Credenciais da API e clique em Gerar Novas Credenciais.
Salve o Client Secret imediatamente — ele não será exibido novamente.

​
Passo 2: Obter Access Token

curl -X POST https://api-hub-campaign.convertt.ai/api/v1/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "SEU_CLIENT_ID",
    "client_secret": "SEU_CLIENT_SECRET"
  }'
Guarde o access_token da resposta.

​
Passo 3: Identificar o Template

Você precisa de um template RCS já aprovado. O templateId pode ser encontrado no Dashboard em Templates.

​
Passo 4: Disparar a Campanha

curl -X POST https://api-hub-campaign.convertt.ai/api/v1/external/campaigns/dispatch \
  -H "Authorization: Bearer SEU_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "campaignId": "'$(uuidgen)'",
    "name": "Teste API - '$(date +%Y%m%d%H%M)'",
    "templateId": "SEU_TEMPLATE_ID",
    "messages": [
      {
        "phone": "5511999999999",
        "uid": "teste-001",
        "vars": { "nome": "Teste" }
      }
    ]
  }'

​
Passo 5: Verificar no Dashboard

Acesse Campanhas no dashboard para acompanhar o status de envio e entrega.

​
Próximos Passos