Skip to content

Connect Tripletex

Connect Tripletex so your KonversAI assistant can answer questions about a customer’s invoices: amount, due date, amount outstanding, payment status and KID. You do this on the Assistant tools screen in the KonversAI console. Select Settings in the left sidebar, then select AI tools. Add a tool of type Tripletex. The assistant looks up invoices only after the customer verifies an email address or a phone number. The assistant only reads from Tripletex. The assistant never creates or changes anything in Tripletex.

A team member with the View tools permission opens the Assistant tools screen in the KonversAI console. A team member with the Modify tools permission adds, edits, tests and deletes. A Tenant Admin holds both permissions, always. Without View tools, the item AI tools does not appear under Settings in the left sidebar. Ask a Tenant Admin to grant Modify tools on the User permissions screen.

Sign in to the KonversAI console and select your tenant. Select Settings in the left sidebar, then select AI tools. The screen heading is Assistant tools.

You also need an employee token from Tripletex. Tripletex calls the token a brukernøkkel. KonversAI supplies the rest of the Tripletex connection. You paste only the employee token. To create the employee token in Tripletex:

  • Tripletex needs the add-on Integrasjoner. Ordering Integrasjoner needs the Smart package or higher, and an account or user administrator. The Komplett package includes Integrasjoner already.
  • You need to be a user administrator in Tripletex. Only a user administrator sees the API-tilgang tab.
  • The employee token belongs to one Tripletex user, and never gets more access than that user. Pick a user with read access to customers and invoices.

Tripletex describes these steps in its own help: Aktivere integrasjoner, Lage brukernøkkel and Sende brukernøkkel.

The assistant finds a customer in Tripletex from the verified email or phone in the conversation. A verified email matches the customer’s email, the customer’s invoice email, or the email of a contact person registered on the customer. A verified phone matches the customer’s mobile number. Make sure those fields are filled in Tripletex for the customers who will ask.

Tripletex is not behind a feature flag. Shared fields such as Display name, Slug and Usage guidance for the AI assistant work like any other tool. See Give the assistant a tool.

Skip steps 1 to 3 when your Tripletex company has the Komplett package, or already has Integrasjoner.

  1. In Tripletex: In the main menu, select Selskap, then Mitt abonnement.
  2. In Tripletex: Under Utforsk flere tilleggstjenester, order Integrasjoner.
  3. In Tripletex: Read the terms, then select Aktiver.
  1. In Tripletex: In the main menu, select Lønn, then Ansatte. Open the user the employee token will belong to. You can also open your own user. The employee token never gets more access than this user.
  2. In Tripletex: Select the API-tilgang tab. Only a user administrator sees API-tilgang.
  3. In Tripletex: Select Ny nøkkel.
  4. In Tripletex: Check Tilpasset oppsett. KonversAI is not in the Applikasjon list, so leave Applikasjon empty.
  5. In Tripletex: In Applikasjonsnavn, type KonversAI exactly. Tripletex matches the name with upper and lower case, so Konversai does not work.
  6. In Tripletex: Choose the access for the employee token. The access must include reading customers and invoices. KonversAI never writes to Tripletex. Bestem selv starts the employee token with no access at all, so invoice lookups find nothing until you add access.
  7. In Tripletex: In Gi nøkkelen et navn, type a name you will recognise later, such as KonversAI.
  8. In Tripletex: Select Opprett nøkkel. Copy the employee token from the dialog. Tripletex shows the employee token only once. Treat the employee token like a password. Do not paste the employee token into chat or a ticket.
  1. In KonversAI: Select Settings in the left sidebar, then select AI tools. The screen opens with the heading Assistant tools.
  2. In KonversAI: Select + Add tool. The Add tool screen lists every tool type. Type Tripletex in the search field, or select the category Accounting.
  3. In KonversAI: Select Tripletex. The form opens with the heading Add tool.
  4. In KonversAI: Type a label in Display name. KonversAI fills Slug while you type.
  5. In KonversAI: Keep Enabled switched on.
  6. In KonversAI: Select Add tool at the bottom. KonversAI saves the tool and opens it with the heading Edit tool.
  7. In KonversAI: In the Connection card, select Add secret on Employee token. Paste the employee token in Secret value, then select Save. The status changes from Not set to Configured.
  8. In KonversAI: Select Test connection. Success looks like: Connected to Acme Regnskap AS. The company name is your Tripletex company.
  9. In KonversAI: Read any warning under the success message. The employee token cannot read customers and invoices. In Tripletex, give the API user access to customers and invoices, or invoice lookups will find nothing. means the employee token works but cannot read that data. Fix the access in Tripletex, then select Test connection again.
  10. In KonversAI: Optional: in the Configuration card, set Invoice history (days). The default is 365 days. The maximum is 1095 days. The assistant and the contact card search invoices dated within this period.
  11. In KonversAI: Select Save changes.

Tripletex is a tool type on the Assistant tools screen in the KonversAI console. Select Settings in the left sidebar, then select AI tools, then select + Add tool, and choose Tripletex. After a customer verifies an email address or a phone number, the assistant can list that customer’s recent invoices, or check one invoice by its invoice number. The assistant tells the customer the amount, the due date, the amount outstanding, the payment status and the KID. The tool only reads from Tripletex. The tool never creates, sends or changes an invoice.

Why does the assistant ask the customer to verify an email address first?

Section titled “Why does the assistant ask the customer to verify an email address first?”

The Tripletex tool shows invoices only to a customer who has verified an email address or a phone number in the conversation. The assistant asks for verification before the first invoice lookup. The assistant does not use an email address or an invoice number the customer only types in chat. A customer can check one invoice by its number, but only an invoice that belongs to the customer the verified email or phone matched. To let customers verify a phone number, add a Phone Verification tool on the Assistant tools screen.

Why does the assistant say no customer matches?

Section titled “Why does the assistant say no customer matches?”

The assistant found no Tripletex customer for the verified email or phone. In Tripletex, check the customer record. A verified email matches the customer’s email, the customer’s invoice email, or the email of a contact person on the customer. A verified phone matches only the customer’s mobile number, not a contact person’s phone. The match is exact: a different spelling of the email address does not match. When no customer matches, the assistant offers to pass the question to a person instead of guessing.

Why does the assistant find no invoices for a customer I know has invoices?

Section titled “Why does the assistant find no invoices for a customer I know has invoices?”

The Tripletex tool searches invoices dated within Invoice history (days). The default is 365 days. Open the Tripletex tool from Settings, then AI tools, in the KonversAI console. Raise Invoice history (days) up to 1095 days, then select Save changes. Also select Test connection. A warning that the employee token cannot read invoices means the Tripletex user behind the token lacks access to invoices.

Select Test connection on the Edit tool screen for Tripletex in the KonversAI console. Missing required settings: employee_token means Employee token is empty. Add the secret, then test again. Tripletex rejected the employee token. Check that it was created for the KonversAI integration and has not been deleted. means Tripletex refused the token. Create a new employee token in Tripletex and paste it again. Tripletex is temporarily rate-limiting requests. Please try again shortly. means Tripletex is busy. Wait a minute, then test again. Could not reach Tripletex (network timeout or connection error). means Tripletex did not answer. Try again later. Tripletex is not yet available on this platform. Contact KonversAI support. means KonversAI has not switched Tripletex on for your workspace yet. Contact KonversAI support.

Why is KonversAI not in the Applikasjon list in Tripletex?

Section titled “Why is KonversAI not in the Applikasjon list in Tripletex?”

KonversAI is not listed in Tripletex’s integration catalogue, so the Applikasjon list in Tripletex does not show KonversAI. Create the employee token with a custom setup instead. In Tripletex, open the user, select the API-tilgang tab, then select Ny nøkkel. Check Tilpasset oppsett, and type KonversAI in Applikasjonsnavn, with exactly that upper and lower case. If you lose the employee token, create a new one in Tripletex and paste the new employee token into the Tripletex tool in the KonversAI console.

What do operators see on the contact card?

Section titled “What do operators see on the contact card?”

When a verified customer matches a Tripletex customer, the contact card in the KonversAI console shows a Tripletex card. Open a conversation under Conversations, and read the End user section of Conversation Details. The Tripletex card lists recent invoices, such as Invoice 10023, with a status: Paid, Unpaid, Partially paid, Overdue, Credited or Credit note. Badges show the matched customer with the customer number, and the total outstanding in each currency, such as Outstanding NOK. The card counts only invoices within Invoice history (days).

The Tripletex card in the KonversAI console and the assistant use the same statuses. Paid means nothing is outstanding. Unpaid means the invoice is not paid and not yet due. Partially paid means some of the invoice is paid and the invoice is not yet due. Overdue means the due date has passed and an amount is outstanding. Credited means a credit note cancelled the invoice, so nothing is due. Credit note means the document is a credit note, not a bill. The amount outstanding does not include reminder fees. A payment can take a few days to show in Tripletex, so the assistant never promises that a payment made today is registered.

Does the assistant use Tripletex when it replies to a public product review?

Section titled “Does the assistant use Tripletex when it replies to a public product review?”

No. A reply to a product review is public, so the assistant never looks up invoices there. The Tripletex tool works in private conversations, such as the chat widget, after the customer verifies an email address or a phone number.

Last reviewed . Tell us when a step no longer matches the product.