Not every campaign starts with a ready-made list. Two other sources put Tino to work without you having to upload a file: your own system notifying each new contact, or a word the customer writes first.
Campaigns is a feature of the Scale and Enterprise plans. Who configures it: Administrator (Company), Company Manager, Area Manager, and Unit Manager.The Tartini interface is in Portuguese. Screen and button names appear here exactly as on screen, with the translation in parentheses.
Webhook campaign
A webhook campaign lets your system, such as your CRM, e-commerce, or billing platform, notify Tartini every time there’s a new contact to reach out to, for example an abandoned cart. Every contact sent already enters the campaign, with no further step from you.
Where to find it: step 2 of the wizard, Meu sistema envia (My system sends) source.
Choose the source
In the Público (Audience) step, check Meu sistema envia.
Continue the wizard
There’s nothing to fill in for this source besides the rest of the campaign (mission, channel, hours). The URL only exists after you create it.
Create the campaign
When you click Criar campanha (Create campaign), a Conecte seu sistema (Connect your system) modal shows up with the webhook URL and the secret token.
Copy the URL and the token
Use the copiar (copy) buttons next to each one. The token stays hidden by default; click revelar (reveal) to see it.
Hand it to your technical team
Send the URL and the token to whoever sets up your system. They need to send a POST to that URL for every new contact, with the name and phone in the message body.
The URL and the token also stay available later, at any time, on the Detalhes (Details) tab of the campaign dashboard. You don’t need to save the creation modal.
The payload example shown in the modal and on the Detalhes tab shows the expected format: the contact’s name and phone in one block, and any other data (like the cart value) in a second block, which becomes context data available for Tino to use in the conversation. The technical details of signing and the full payload format are in the developers tab.
Choose when Tino reaches out
Immediate
Disparar imediatamente ao receber (Trigger immediately on receipt) reaches out to each contact as soon as it arrives, 24 hours a day.
Within the window
Somente dentro da janela de horários (Only within the time window) waits for the next configured time slot if the contact arrives outside it.
A contact that arrives outside the time window sits in the Fila de Eventos (Event queue), on the tab of the same name in the campaign dashboard, and is processed at the next available time slot, with no action from you.
Rotate the token if needed
If the token leaks or you want to invalidate the old URL, regenerate the token on the Detalhes tab of the campaign dashboard.
Regenerating the token drops the old URL immediately. Update the URL in every system that uses this webhook before regenerating, so you don’t lose new contacts.
Keyword campaign (inbound)
A keyword campaign activates Tino when a person writes on the channel with the campaign’s subject: a registered word or phrase, a phrase similar to it or, with the option turned on, the same intent in other words. Tino replies to what the person wrote.
Where to find it: Público (Audience) step of the wizard, Palavra-chave (Keyword) source, Como a campanha reconhece quem entra (How the campaign recognizes who enters) section.
Choose the source
In the Público step, check Palavra-chave.
Set how the campaign recognizes who enters
Register words and phrases and, if you want, turn on Frase parecida (Similar phrase), Entender a intenção (Understand the intent), or Campanha padrão para conversas novas deste canal (Default campaign for new conversations on this channel).
Set the tag applied to the contact
Choose a color and write the tag’s text, for example BF25. It tags the contact as soon as they enter the campaign.
Test a message
Paste a text in testar mensagem (test message) to see whether it would activate the campaign and in which way.
Each way of recognizing, the channel default campaign, and entry from the Inbox are in Set how the campaign recognizes who enters.
There’s no external connection step for this source: everything happens inside Tartini.
Where to track it after it’s created
- Campaign dashboard, Detalhes tab: the webhook’s URL and token, or the keyword’s pattern and tag.
- Campaign dashboard, Fila de Eventos (Event queue) tab (webhook) or Execuções (Executions) tab (keyword): one record per contact that entered.
- Inbox: conversations opened by a campaign show a Campanha (Campaign) chip, and the Entrou na campanha (Entered the campaign) line says why the person entered.
Frequently asked questions
I lost the webhook URL, how do I get it back?
Open the campaign dashboard, Detalhes tab. The URL and the copy button are still there.
What happens to a contact that arrives outside the time window?
It enters the Fila de Eventos and is processed as soon as the window opens again, with no action from you.
Can I cancel an event that's waiting in the queue?
Not through the interface today. It waits for the next available time slot.
Does the keyword campaign repeat for every message from the same contact?
No. While the campaign conversation is ongoing, the person doesn’t enter again. With Aplicar somente na primeira mensagem (Apply only to the first message) unchecked, a registered word also activates the campaign in the middle of a conversation that isn’t in it yet.
The person edited the ad's message and didn't enter. What do I do?
Can I switch from webhook to list after creating the campaign?
No. The source of the contacts is set at creation and doesn’t change when editing.
Related articles