Home Others
⬛

Others

Tech
By Tech
β€’ 2 articles

How to Create an Integration to Create Tickets in Jira Using Automation + Webhook + n8n

The Cloud Chat allows sending events to external systems through the "Send Webhook Event" feature in automations. With this feature, it is possible to integrate Cloud Chat with virtually any system β€” including Jira β€” by using an automation intermediary, such as: - n8n - Zapier - Make - Plugga The flow of the integration typically follows this logic: 1. An automation in Cloud Chat triggers a webhook. 2. The intermediary tool (e.g., n8n) receives the event. 3. The data is processed or adapted as needed. 4. An issue (ticket) is created automatically in Jira. This integration is usually triggered by ticket updates, such as: - adding a tag - changing a custom conversation attribute - changing priority - changing the responsible team When any of these conditions occur, the webhook is fired, initiating the process of creating the Jira ticket. This type of integration is commonly used to route support requests to other teams, especially in cases like: - Customer-reported bugs - Technical incidents - Issues requiring engineering analysis - Escalation to technical teams. Integration flow: Updated Ticket in CloudChat (tag or custom attribute) ↓ Automation triggers Webhook ↓ n8n receives event ↓ n8n transforms data ↓ n8n creates Issue in Jira ⚠️ Bidirectional (two-way) integrations β€” where Jira also updates CloudChat β€” are more complex and usually require combined use of Webhook + CloudChat APIs + Jira APIs. Step 1 β€” Create the Automation in CloudChat The first step is to create an automation based on ticket updates. This automation will be responsible for firing the webhook. Trigger Examples You can use different conditions, such as: Tag added to the ticket Example: tag added = bug Custom attribute updated Example: conversation_custom_field = engineering_escalation value = true Priority change priority = high Automation Example Event Ticket updated Condition tag added = bug or custom field engineering_escalation = true Action Send Webhook Event Step 2 β€” Create the Webhook in n8n In n8n, create a workflow with a Webhook Node. Configuration Node: Webhook Method: POST Path cloudchat-jira n8n will generate a URL like: https://n8n.yourdomain.com/webhook/cloudchat-jira This URL should be configured in the CloudChat automation. Step 3 β€” Understand the Payload Sent by CloudChat When the automation triggers, CloudChat sends a POST with JSON containing event information. Example Payload { "event": "conversation_updated", "message_type": "incoming", "content": "Customer reported an error when generating the invoice", "conversation": { "id": 678, "status": "open" }, "sender": { "id": 90, "name": "John Smith", "email": "[email protected]", "phone_number": "+5511999999999" }, "inbox": { "id": 10, "name": "WhatsApp" } } Commonly used fields in the integration: - conversation.id: Ticket ID - content: Most recent message - sender.name: Customer's name - sender.email: Customer's email - sender.phone_number: Customer's phone - inbox.name: Channel Step 4 β€” Enrich Data (Optional) Depending on the integration, it may be necessary to gather more information before creating the Jira ticket. In this case, n8n can use Real-Time Query APIs of CloudChat. Common use cases: - Fetch conversation history - Fetch contact data - Fetch other messages of the ticket Example endpoint: GET /api/client/accounts/{ACCOUNT_ID}/conversations/{CONVERSATION_ID}/messages This step is useful when the technical team needs more context about the conversation. Step 5 β€” Create the Jira Ticket in n8n After receiving the webhook and preparing data, n8n can create a Jira Issue. Typical configuration Operation Create Issue Main Fields - Jira Project: Engineering project - Issue Type: Bug - Summary: Bug reported via CloudChat - Description: Customer message - Reporter: Customer's email Example of Description Sent to Jira Bug reported via CloudChat Customer: {{sender.name}} Email: {{sender.email}} Phone: {{sender.phone_number}} Message: {{content}} Ticket link: https://cloudchat.cloudhumans.com/app/accounts/{ACCOUNT_ID}/conversations/{{conversation.id}} This allows the technical team to quickly access the original ticket in CloudChat. Step 6 β€” Test the Integration Recommended testing flow: 1. Create the automation in CloudChat 2. Set up the webhook in n8n 3. Manually update the ticket (e.g., add tag bug) 4. Check if the webhook was triggered 5. Confirm that the n8n workflow executed 6. Verify that the ticket was created in Jira Best Practices Use Clear Triggers Avoid creating Jira tickets for any ticket update. Prefer using: - Specific tags (bug, engineering) - Custom fields (escalate_to_tech) - High priority Always Send the Ticket Link Include in Jira the direct link to the conversation in CloudChat. Example: https://cloudchat.cloudhumans.com/app/accounts/{ACCOUNT_ID}/conversations/{CONVERSATION_ID} This facilitates problem investigation. Avoid Duplicates If the ticket is updated multiple times, the automation might trigger multiple webhooks. To prevent this, you can: - Use a specific escalation tag - Validate within n8n if a ticket issue already exists for that conversation Integration Limitations This type of integration has some limitations: Typically one-way integration CloudChat β†’ Jira Jira does not automatically update the ticket in CloudChat. For bidirectional integration, it would be necessary to use: - Jira Webhooks - CloudChat Update APIs - Additional logic in n8n

Last updated on Mar 12, 2026

How to Fix Error 550 5.7.515 β€” Email Authentication via Google Workspace

When to use this - You use Google Workspace and the messages you send from Cloud Chat to Microsoft recipients (Outlook, Hotmail, Live, Microsoft 365) are being rejected with error 550 5.7.515 - Sending directly from Gmail works, but sending from Cloud Chat (or any other third-party platform) fails - You need to configure SPF, DKIM, and DMARC aligned to your domain in order to meet Microsoft's requirements Prerequisites - Super Admin access to Google Workspace (admin.google.com) - Access to your domain's DNS provider (Registro.br, Cloudflare, GoDaddy, AWS Route 53, etc.) - Gmail enabled on the domain for at least 24 to 72 hours before generating the DKIM key - Email inbox connected β€” see How to connect a Google email inbox to Cloud Chat :::error Replace SEUDOMINIO.COM.BR with your actual domain throughout this document. The examples use this placeholder for illustration only. ::: About this article This error is not a Cloud Chat weakness β€” the same thing would happen with any customer service platform that sends emails on behalf of your domain. When you send directly from Gmail, the message leaves Google's servers β€” which are already authorized in SPF and automatically sign DKIM with your domain. Everything passes. When the email leaves through Cloud Chat (or any third-party platform), it comes from different servers, which are not in your domain's SPF and do not have access to its DKIM key. The result: SPF fails, DKIM does not align, DMARC does not pass, and Microsoft rejects the message with 550 5.7.515: 550 5.7.515 Access denied, sending domain SEUDOMINIO.COM.BR doesn't meet the required authentication level. The sender's domain in the 5322.From address doesn't meet the authentication requirements defined for the sender. Spf=Fail , Dkim=Pass , DMARC=None The root cause: the domain does not have SPF, DKIM, and DMARC properly configured. Sending directly from Gmail "hides" the problem because Google handles it automatically for its own servers. Any sending from outside exposes the gap. This guide fixes that configuration in Google Workspace and at your DNS provider. Once applied, authentication passes both through Gmail and through Cloud Chat. Diagnosis Microsoft rejects your messages because there is no authentication aligned with the domain in the From: header. The bounce header usually shows: - SPF = Fail β€” the SPF record does not include _spf.google.com, or does not exist - DKIM = Pass, but without alignment β€” Google signs with d=gmail.com instead of d=<your-domain>. It technically passes, but it does not count toward DMARC - DMARC = None β€” no DMARC record is published :::info Since late 2024, Microsoft requires at least one authentication mechanism aligned with the From: header for high-volume senders (β‰₯ 5,000 messages to outlook.com, hotmail.com, live.com, msn.com). If you are already getting this error, your domain has crossed that threshold. ::: :::info About alignment: for DMARC to pass, only SPF or DKIM needs to be aligned. This guide configures both for greater reliability, but aligned DKIM (Step 2) is the main component. ::: Inspect the header of a bounced message Before touching DNS, confirm the current state. Find a bounced message with code 550 5.7.515, open it in Gmail, and click Show original. Look for the Authentication-Results line: Authentication-Results: ... spf=fail (sender IP is ...) smtp.mailfrom=<seu-dominio>; dkim=pass header.d=gmail.com; ← d=gmail.com = NO alignment dmarc=none action=none header.from=<seu-dominio>; If this is the pattern you see, follow this guide. If it is different (for example, SPF pass, DMARC quarantine), the investigation needs to go another way β€” open a support ticket. Step by step Step 1 β€” Publish the SPF record At your DNS provider, publish (or update) a TXT record at the domain apex: | Field | Value | | --- | --- | | Type | TXT | | Host / Name | @ (or the domain itself) | | Value | v=spf1 include:_spf.google.com ~all | | TTL | 3600 | :::error There can only be one single SPF record per domain. If one already exists, edit it and merge the includes: v=spf1 include:_spf.google.com include:outro-servico.com ~all ::: Verification: dig TXT <seu-dominio> +short # Should return a line containing v=spf1 include:_spf.google.com ~all Step 2 β€” Configure DKIM in Google Workspace (main step) This is the most important step. It makes Google sign your messages with d=<your-domain> instead of d=gmail.com, solving the alignment problem. 2.1 β€” Generate the DKIM key 1. Go to admin.google.com as a Super Admin 2. Go to Menu β†’ Apps β†’ Google Workspace β†’ Gmail β†’ Authenticate email 3. Select your domain and click Generate new record 4. Configure: 2048 bits, selector prefix: google 5. Copy the two values shown: - DNS host name: google._domainkey - TXT value: a long text starting with v=DKIM1; k=rsa; p=MIIBIjAN... :::warning Button disabled? Wait 24–72h after Gmail was enabled on the domain. ::: 2.2 β€” Publish the DKIM record in DNS | Field | Value | | --- | --- | | Type | TXT | | Host / Name | google._domainkey | | Value | Text copied from the Admin console | | TTL | 3600 | 2.2.1 β€” CharacterStringTooLong error when publishing DKIM Symptom When publishing the google._domainkey TXT record, the provider shows an error similar to: ⚠️ An error occurred. Please try again later. CharacterStringTooLong (Value is too long) encountered with '"v=DKIM1; k=rsa; p=XXXXXXXX..."' The record is not saved and DKIM authentication cannot be turned on. Cause RFC 1035 (section 3.3) limits each character-string in a TXT record to 255 characters. The 2048-bit RSA public key generated by Google Workspace exceeds that limit (β‰ˆ400 characters), so the provider rejects it when the value is sent as a single string. It is not a problem with the key or with Google Workspace β€” it is a DNS protocol limitation. Solution Break the value into multiple strings of up to 255 characters, each one in double quotes and separated by a space. The DNS server automatically concatenates them on delivery, and the resolver sees a single continuous DKIM key. Expected format: "v=DKIM1; k=rsa; p=XXXXXXXXXXXXXXXXXXXXXXXXXXXX...ate_255_chars" "continuacao_ate_255_chars..." "parte_final_da_chave" How to break up the key 1. Paste the value copied from the Admin console (v=DKIM1; k=rsa; p=...) into a text editor 2. Every 255 characters of content, insert " " (quote β€” space β€” quote) 3. Wrap the entire value in double quotes at the beginning and at the end 4. Paste the result into the Value / Content field of the TXT record :::info Tip: Do not count the outer quotes toward the 255 limit β€” only the string content. ::: Behavior by DNS provider: | Provider | How to paste | | --- | --- | | Cloudflare | Paste the already-split value with quotes and spaces into the Content field. The UI accepts it directly. | | AWS Route 53 | Paste the split strings with quotes into the Value field. Each string on a separate line also works. | | Registro.br | Multiple quoted strings on a single line. | | GoDaddy / HostGator / others | They accept the same format. If the UI refuses quotes, look for the raw or advanced option. | Verification After saving and waiting for propagation (up to 30 minutes), validate: dig TXT google._domainkey.<seu-dominio> +short The output should show the concatenated key. If the response shows several separate strings, it is still valid β€” what matters is that the reconstructed RSA key is identical to the value in the Admin console. To confirm, compare the key returned by dig with the one from the generation step in Google Workspace. 2.3 β€” Turn on authentication 1. Go back to Gmail β†’ Authenticate email in the Admin console 2. Click Start authentication 3. Wait for the status to change to Authenticating email with DKIM :::warning It can take up to 48 hours to start working. ::: Verification: dig TXT google._domainkey.<seu-dominio> +short # Should return the complete v=DKIM1; k=rsa; p=... Step 3 β€” Publish the DMARC record :::error Only publish DMARC after SPF and DKIM have been authenticating correctly for at least 48 hours. ::: | Field | Value | | --- | --- | | Type | TXT | | Host / Name | _dmarc | | Value | v=DMARC1; p=none; rua=mailto:dmarc-reports@<seu-dominio>; pct=100; adkim=s; aspf=s | | TTL | 3600 | Create a mailbox or alias dmarc-reports@<seu-dominio> to receive the aggregate reports (XML) that providers send daily. Hardening roadmap Only move to the next phase after at least one week with no false positives in the reports. | Phase | Week | Policy | Effect | | --- | --- | --- | --- | | 1 β€” Monitoring | 0 | p=none | Only generates reports | | 2 β€” Partial quarantine | β‰₯ 1 | p=quarantine; pct=10 | 10% of unauthenticated messages go to spam | | 3 β€” Full quarantine | β‰₯ 2–3 | p=quarantine; pct=100 | All of them go to spam | | 4 β€” Rejection | β‰₯ 4 | p=reject; pct=100 | The server rejects unauthenticated messages | Quick unblock (if it is urgent) If you need to unblock sending to Microsoft recipients right away, publish only: 1. Step 1 β€” the SPF record 2. Step 3 β€” the DMARC record with p=none (without waiting the 48h for DKIM) In most cases this alone ends the 550 5.7.515 error, because Microsoft specifically targets domains with no DMARC at all. Having a published DMARC (even a permissive one) already changes how you are treated. :::warning Step 2 (aligned DKIM) is still the definitive fix and must be carried out afterwards β€” without it, SPF and DMARC rest on a fragile foundation. ::: Final verification After propagation (30 min for SPF/DMARC, up to 48h for DKIM): dig TXT <seu-dominio> +short # SPF dig TXT google._domainkey.<seu-dominio> +short # DKIM dig TXT _dmarc.<seu-dominio> +short # DMARC Functional test Send a test email to any @outlook.com or @hotmail.com address or Microsoft 365 account. In the header of the received email, check: Authentication-Results: ... spf=pass smtp.mailfrom=<seu-dominio>; dkim=pass header.d=<seu-dominio>; ← proof of alignment dmarc=pass header.from=<seu-dominio>; :::success If all three lines show pass with header.d=<seu-dominio> and header.from=<seu-dominio>, the configuration is correct β€” the 550 5.7.515 error will not happen again. ::: :::warning If dkim=pass still shows header.d=gmail.com, Step 2.3 has not been completed yet or DNS is still propagating. Wait a few more hours and test again. ::: Official sources - Set up DKIM β€” Google Workspace Admin Help - Turn on DKIM for your domain β€” Google Workspace Admin Help - Set up SPF β€” Google Workspace Admin Help - Define your SPF record β€” Google Workspace Admin Help - Add your DMARC record β€” Google Workspace Admin Help - Recommended DMARC rollout β€” Google Workspace Admin Help - Email sender guidelines β€” Google Workspace Admin Help - Microsoft: Fix NDR error 550 5.7.515 β€” Outlook.com Notes - To connect a Gmail inbox to Cloud Chat: How to connect a Google email inbox to Cloud Chat - To connect an Outlook inbox to Cloud Chat: How to connect an Outlook/Microsoft email inbox to Cloud Chat - To understand how email attachments work: How email attachments work in Cloud Chat

Last updated on Aug 03, 2026